Silme:0.7: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(16 intermediate revisions by 3 users not shown)
Line 1: Line 1:
List of features planned for Silme 0.7
List of features planned for [[Silme]] 0.7


* HTML serializerier for silme.diff objects
* '''Main contacts needed for 0.7 release'''
* Sections support for l10nobjects
** Dev lead (Gandalf)
* Processing external entities
** Dev backup (Adrian?)
* Add user interaction options for clean_obsolete script
** Code review (Axel)
* '''Overall goal of this release'''
** Extend internal data structures to support sections
** Improve the quality of output of several silme based tools
** Consider shortening API names
* '''Initial time-line'''
** '''Free hacking!'''
*** Sections support for l10nobjects
*** Processing external entities
*** L10nObjectDiff.get_entity() should be less time consuming (better not to do get_entitylistdiff which does get_entities to get one single entity...)
*** Support plural forms for Gettext
** '''June 5 - data structure freeze'''
*** (much) Shorter names for classes, methods and method arguments needed. We should create a naming convention for that, probably. [[Silme:Naming_convention|Brainstorming page with proposals]].
*** Extend L10nPackage.get_entities to be able to get list in form of [Entity, internal_path] (or add get_entities_with_path)
** '''June 15 - API freeze'''
*** HTML serializerier for silme.diff objects
*** Add user interaction options for clean_obsolete script
*** Add silme.format.mozlang (stas)
** '''June 25th - Code freeze'''
*** Consider migrating documentation to MDC - Seth
** '''June 30th - 0.7 Release'''
*** blog about it! :) (0.5->0.7 blog)
* '''Any external dependencies'''
** Adrian, Pike, Stef - feedback on API naming scheme
** Adrian/Romi/Gandalf to do testing
 
== Bugzilla ==
 
* [https://bugzilla.mozilla.org/show_bug.cgi?id=495229 tracking bug]
 
== Feature Summary ==
* Support for plurals
** '''Feature explanation:''' Add support for entities requiring plural forms in silme.core
***  Bug [https://bugzilla.mozilla.org/show_bug.cgi?id=496359 496359] tracks the progress on this feature.
** Both gettext and l20n have support for plural forms
** Presently, Silme is pretty specific to gettext, and we want to migrate it closer to l20n one day
 
* Get a flat list of entities from a structure
** '''Feature explanation:''' Present a flat list of untranslated entities as output, instead of the nested package structure
*** When asking for untranslated entities in a flat list, Silme will now return a list of pairs:  entity *with* the path
***  Using the path, you can write back to the proper place in the structure
** End-user can work on entity-list without having to dig through structure
** This will be used by Koala project
** Bug [https://bugzilla.mozilla.org/show_bug.cgi?id=497196 497196] tracks Silme's ability for L10nPackage.get_entities to return entities with paths
**  Bug [https://bugzilla.mozilla.org/show_bug.cgi?id=496372 496372] provides the entity list of untranslated strings
 
* Simplification of the API
** '''Feature explanation:''' Rename Silme's long method and class names with shorter names
** Made class names shorter when possible
** Bug [https://bugzilla.mozilla.org/show_bug.cgi?id=498915 498915] tracks this progress
 
* Processing
** '''Feature explanation:''' Process entities so that processed value of an entity is provided in place of the source name
**  DTD files are loaded with variables like "%sBrandShortName"
** Take entity, process it, and not return the source name of the entity, but the "processed" value
** Silme users then can see the actual structure of the sentence
 
* Split to repositories
** Silme Library
** Silme Scripts
** Easier to package in easy_install
** Maintain the library code
** Does rely on any script
 
* Extended l20n format serializer
** '''Feature explanation:''' Write l20n files with Silme
*** Bug [https://bugzilla.mozilla.org/show_bug.cgi?id=499145 499145] tracks this feature
 
* HTML diff output
**  '''Feature explanation:''' With this feature, we plan to add an HTML format serializer for silme.diff.* to Silme so we can present diffs generated from Silme's compare-locales in HTML format
**  Bug [https://bugzilla.mozilla.org/show_bug.cgi?id=491715 491715]
 
* Clean obsolete scripts
**  '''Feature explanation:'''  This feature will allow obsolete entities within a localization to be removed using a Silme command.
**  Bug [https://bugzilla.mozilla.org/show_bug.cgi?id=500339 500339] tracks this progress.

Latest revision as of 04:21, 25 June 2009

List of features planned for Silme 0.7

  • Main contacts needed for 0.7 release
    • Dev lead (Gandalf)
    • Dev backup (Adrian?)
    • Code review (Axel)
  • Overall goal of this release
    • Extend internal data structures to support sections
    • Improve the quality of output of several silme based tools
    • Consider shortening API names
  • Initial time-line
    • Free hacking!
      • Sections support for l10nobjects
      • Processing external entities
      • L10nObjectDiff.get_entity() should be less time consuming (better not to do get_entitylistdiff which does get_entities to get one single entity...)
      • Support plural forms for Gettext
    • June 5 - data structure freeze
      • (much) Shorter names for classes, methods and method arguments needed. We should create a naming convention for that, probably. Brainstorming page with proposals.
      • Extend L10nPackage.get_entities to be able to get list in form of [Entity, internal_path] (or add get_entities_with_path)
    • June 15 - API freeze
      • HTML serializerier for silme.diff objects
      • Add user interaction options for clean_obsolete script
      • Add silme.format.mozlang (stas)
    • June 25th - Code freeze
      • Consider migrating documentation to MDC - Seth
    • June 30th - 0.7 Release
      • blog about it! :) (0.5->0.7 blog)
  • Any external dependencies
    • Adrian, Pike, Stef - feedback on API naming scheme
    • Adrian/Romi/Gandalf to do testing

Bugzilla

Feature Summary

  • Support for plurals
    • Feature explanation: Add support for entities requiring plural forms in silme.core
      • Bug 496359 tracks the progress on this feature.
    • Both gettext and l20n have support for plural forms
    • Presently, Silme is pretty specific to gettext, and we want to migrate it closer to l20n one day
  • Get a flat list of entities from a structure
    • Feature explanation: Present a flat list of untranslated entities as output, instead of the nested package structure
      • When asking for untranslated entities in a flat list, Silme will now return a list of pairs: entity *with* the path
      • Using the path, you can write back to the proper place in the structure
    • End-user can work on entity-list without having to dig through structure
    • This will be used by Koala project
    • Bug 497196 tracks Silme's ability for L10nPackage.get_entities to return entities with paths
    • Bug 496372 provides the entity list of untranslated strings
  • Simplification of the API
    • Feature explanation: Rename Silme's long method and class names with shorter names
    • Made class names shorter when possible
    • Bug 498915 tracks this progress
  • Processing
    • Feature explanation: Process entities so that processed value of an entity is provided in place of the source name
    • DTD files are loaded with variables like "%sBrandShortName"
    • Take entity, process it, and not return the source name of the entity, but the "processed" value
    • Silme users then can see the actual structure of the sentence
  • Split to repositories
    • Silme Library
    • Silme Scripts
    • Easier to package in easy_install
    • Maintain the library code
    • Does rely on any script
  • Extended l20n format serializer
    • Feature explanation: Write l20n files with Silme
      • Bug 499145 tracks this feature
  • HTML diff output
    • Feature explanation: With this feature, we plan to add an HTML format serializer for silme.diff.* to Silme so we can present diffs generated from Silme's compare-locales in HTML format
    • Bug 491715
  • Clean obsolete scripts
    • Feature explanation: This feature will allow obsolete entities within a localization to be removed using a Silme command.
    • Bug 500339 tracks this progress.