Defensive and secure coding guide: call for renaming files

Jérôme Fenal jfenal at gmail.com
Sun Aug 25 08:04:51 UTC 2013


Hi all,

The Defensive and coding guide sports an interesting and forgotten feature
in its file organization: directories.
Beyond directories, it also happens to show files having the same name
(such as Language.xml, found in Python/, Java/, CXX/, C/, etc. or
schema.xml).

You tell me, that is what directories are for. Fair enough.

The real issue here is that pushing .po resulting from those XML files to
Transifex which only handles uniquely named resources in a flat hierarchy
leads to a mess, where there is no predictibility in having the Language
resource always the same on Transifex, depending how those are pushed.

Could it be possible to rename all those files to unique names, ideally
with the subdir as a prefix (such as CXX-Language.xml or C-schema.xml) so
that we have unique resource names in Transifex?

Furthermore, could we add a requirement to documentation authors in order
to ensure that all XML files in their document hierarchy show unique names?

Regards,

J.
-- 
Jérôme Fenal
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.fedoraproject.org/pipermail/docs/attachments/20130825/c53be7f9/attachment.html>


More information about the docs mailing list