Silme:0.7

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

• tracking bug

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.