Changes between Version 55 and Version 56 of Notifications

Timestamp:

Dec 11, 2009, 11:17:30 AM (14 years ago)

Author:

romw

Comment:

Move the section on server message localization to feed localization

Notifications

@@ -70 +70 @@
  * Provides a mechanism to display localizable server messages within the user interface.
 
+=== Localization ===
+Items being passed to the manager by way of the server scheduler or core client will now be identified by a item identifier.  The item identifier will be appended to the of the project's master url and we used as the item's GUID.
+
+Item identifier rules:
+ * Item identifiers start at 1.
+ * Item identifiers should not be removed from the item list and cannot be removed if no longer used.
+ * Items should be enclosed in the _("Test Message") macro syntax.
+ * Item parameters are enclosed in ‘{}’ braces with an index to the position in which the parameter should replace the marker.
+
+When new items are added poEdit or some other string extraction tool should be used to update the BOINC-Server-Messages.pot template file.  After the localization process has been completed the resulting BOINC-Server-Messages.mo file should be shipped with the client software.
+
+A string in need of localization would look like this:
+{{{
+_("This client needs {1} of additional memory. {2} detected in total.")
+}}}
+
+After translation it could look like this:
+{{{
+_("Your computer has {2} of total detected memory, but the client needs an additional {1} in order to be assigned work.")
+}}}
+
+The client software should replace the positional markers with the optional parameter values specified for the message.
+
 == Feed List ==
 The feed list is published to the client software as part of the client parse-able project preferences.
@@ -128 +151 @@
 A better strategy, using the same schema, is to issue a feeler query that’ll return hints as to which batch queries to issue.  Each positive hint will cause a new query to be issued that uses a join to merge all notification records of a certain type with the details of that type.
 
-For instance if a volunteer has 50 private messages the current scheme would result in a minimum of 51 queries issued against the database, the proposed scheme should result in 2 queries against the database.
-
-Things get progressively worse the more engaged the volunteer is, 50 private messages and 10 threads being watched would result in 61 queries issued in the current scheme, while only 3 queries would be issued in the proposed scheme.
+For instance if a volunteer has 50 private messages the current scheme would result in a minimum of 51 queries issued against the database, the proposed scheme should result in 2 queries against the database. Things get progressively worse the more engaged the volunteer is, 50 private messages and 10 threads being watched would result in 61 queries issued in the current scheme, while only 3 queries would be issued in the proposed scheme.
 
 It is also important to note that the effect of the numbers increase in proportion to the number of machines attached to the project. 
@@ -178 +199 @@
 }}}
 
-=== Localizing Server Messages ===
-Messages being passed to the client by way of the server will now be identified by a message identifier.  
-
-Message identifier rules:
- * Message identifiers start at 1.
- * Message identifiers should not be removed from the message list and cannot be removed if no longer used.
- * Messages should be enclosed in the _("Test Message") macro syntax.
- * Message parameters are enclosed in ‘{}’ braces with an index to the position in which the parameter should replace the marker.
-
-When new messages are added poEdit or some other string extraction tool should be used to update the BOINC-Server-Messages.pot template file.  After the localization process has been completed the resulting BOINC-Server-Messages.mo file should be shipped with the client software.
-
-A string in need of localization would look like this:
-{{{
-_("This client needs {1} of additional memory. {2} detected in total.")
-}}}
-
-After translation it could look like this:
-{{{
-_("Your computer has {2} of total detected memory, but the client needs an additional {1} in order to be assigned work.")
-}}}
-
-The client software should replace the positional markers with the optional parameter values specified for the message.
-
 == BOINC Project Website ==
 A project’s website is the main focal point for adding and removing notification feeds.