incubator-cloudstack-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From sebgoa <run...@gmail.com>
Subject Re: [DISCUSS][DOCS] Conventions for docbook xml filenames to be ready for translation
Date Tue, 11 Dec 2012 11:18:27 GMT
No objections have been raised.

I edited: https://cwiki.apache.org/confluence/display/CLOUDSTACK/How+To+Work+With+CloudStack+Documentation
to make mention of this convention

The patches have been applied by Joe:
https://git-wip-us.apache.org/repos/asf?p=incubator-cloudstack.git;a=commit;h=18d7595292f336093e5c586b544d911f5a70ac5d
https://git-wip-us.apache.org/repos/asf?p=incubator-cloudstack.git;a=commit;h=400d29be850cd16ba1fd155dc6bfa78e7a75df27

-Sebastien

On Dec 10, 2012, at 5:00 AM, Kimihiko Kitase wrote:

> +1
> 
> -----Original Message-----
> From: Kelceydamage@bbits [mailto:kelcey@bbits.ca] 
> Sent: Saturday, December 08, 2012 2:37 AM
> To: cloudstack-dev@incubator.apache.org
> Subject: Re: [DISCUSS][DOCS] Conventions for docbook xml filenames to be ready for translation
> 
> +1 agreed. 
> 
> Sent from my iPhone
> 
> On Dec 7, 2012, at 9:23 AM, sebastien <runseb@gmail.com> wrote:
> 
>> Hi,
>> 
>> A few of us have been looking at translation of the documentation using transifex.
>> To automate the pushing and pulling of source files and translations from our source
code to the transifex site, we need to follow some basic guidelines for filenames of docbook
xml files that we create in /docs/en-US.
>> 
>> I would like use to vote/agree on:
>> 
>> 1-basename needs to be less or equal to 50 characters in length (<=50)
>> 
>> For instance, these files don't follow the proposed convention:
>> loadbalancer-policy-port-forwarding-rule-usage-record-format.xml
>> ongoing-configuration-of-external-firewalls-loadbalancer.xml
>> troubleshooting-dataloss-on-exported-primary-storage.xml
>> troubleshooting-maintenance-mode-not-working-on-vCenter.xml
>> 
>> 2-basename cannot contain dots (no 4.0 in the basename for instance).
>> 
>> For instance, these files don't follow the proposed convention:
>> added-API-commands-4.0.xml
>> Book_Info_Release_Notes_4.0.xml
>> changed-apicommands-4.0.xml
>> 
>> Regards,
>> 
>> PS: assuming nobody objects, I already submitted a review request that corrects the
existing filenames to make us fully "compliant" with transifex.
>> 
>> -Sebastien


Mime
View raw message