90 likes | 178 Views
Display Text. SDD 1.1 Topic. Current Situation. COSMOS team is implementing a CLI for user interaction Need the ability to specify strings for display to the user This exists in the schema a spec, but proper usage is unclear. Current Situation. SDD producer wants to define a parameter
E N D
Display Text SDD 1.1 Topic
Current Situation • COSMOS team is implementing a CLI for user interaction • Need the ability to specify strings for display to the user • This exists in the schema a spec, but proper usage is unclear
Current Situation • SDD producer wants to define a parameter • Prompting for user interaction should be done in the native language for that user • Strings are externalized into resource bundles for localization teams to translate • Those strings are referenced via “translationKey” in “DisplayTextType”
Current Situation • This is where the spec and schema become unclear • JRE example highlights this <sdd-pd:PackageIdentitysoftwareID="2000-123" packageType="update"> <sdd-common:DescriptiontranslationKey="DESC">Lets you develop and deploy Java(TM) applications on desktops and servers, as well as today's Embedded and Realtime environments. Java SE includes classes that support the development of Java Web Services and provides the foundation for Java Platform, Enterprise Edition (Java EE).</sdd-common:Description> <sdd-common:ShortDescriptiontranslationKey="SHORT_DESC">Java(TM) Platform for software development</sdd-common:ShortDescription> <sdd-common:NametranslationKey="PKG_DISPNAME">Java(TM) Platform, Standard Edition Runtime Environment</sdd-common:Name> ….
Current Situation • Note usage of translationKey and the “hard coded string” • Leaves it unclear as to which the runtime should display • Need to update examples and the spec to provide more guidance
Current Situation • Note usage of translationKey and the “hard coded string” • Leaves it unclear as to which the runtime should display • Need to update examples and the spec to provide more guidance
Current Situation • Package descriptor needs some additional guidance as well <sdd-pd:Contents> <sdd-pd:Content pathname="jre-1_5_0_09-AIX-rpm.bin" id="JRE_RPM" purpose="content"/> <sdd-pd:Content pathname="logging.properties" id="LoggingProperties" purpose="content"/> <sdd-pd:Content pathname="jre_update.xml" id="DD" purpose="deploymentDescriptor"/> <sdd-pd:Content pathname="com/sun/java/jre_en.properties" id="EN_Bundle" purpose=“descriptorLanguageBundle"/> </sdd-pd:Contents> • Should each bundle be enumerated in content? Implication is that SDD must be modified as languages are added.
Current Situation • Alternatively the content ref could be <sdd-pd:Contents> <sdd-pd:Content pathname="jre-1_5_0_09-AIX-rpm.bin" id="JRE_RPM" purpose="content"/> <sdd-pd:Content pathname="logging.properties" id="LoggingProperties" purpose="content"/> <sdd-pd:Content pathname="jre_update.xml" id="DD" purpose="deploymentDescriptor"/> <sdd-pd:Content pathname="com/sun/java/jre.properties" id="EN_Bundle" purpose=“descriptorLanguageBundle"/> </sdd-pd:Contents> • Note removal of country and locale code. Implication is that runtime figures out the resource bundle to load based on deployment environment
Proposal • No proposal as of yet • Vetting with TC to determine actions if any • Schema changes unlikely, most likely specification changes only • Examples will need to be updated as well