[XML-DEV Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message]

Re: Transformation of RelaxNG syntax into presentationof requi

• From: Rick Jelliffe <rjelliffe@a...>
• To: xml-dev@l...
• Date: Tue, 28 Oct 2008 00:56:45 +1100

Michael Kay wrote:
> However much we
> feel this is unfair, it is a fact of life. And I agree that if source code
> is to stand much chance in the open-source world, it is going to have to be
> commented in English.
>   
Surely there are multiple half-way houses?

For example, inline comments in Czech but header comments and variable 
names in English.

I guess I am trying to approach it from the angle "What would a FOSS 
project need to provide, in order to make a workable repository for 
not-fluent-in-English developers to be comfortable working and 
developing in?"  

Or, perhaps, what is the minimal bootstrapping documentation a 
not-fluent-in-English FOSS developer needs to provide in order to have 
comprehensible code?   And, following from that, can source code 
documentation be Wiki-ized so that when developers figure out some block 
that they did not grok from the code they can add it without going 
requiring the source code to need recompilation and QA?

Cheers
Rick Jelliffe

• Follow-Ups:
  • Re: Transformation of RelaxNG syntax into presentation of required markup
    • From: "Peter Hunsberger" <peter.hunsberger@g...>

• References:
  • Transformation of RelaxNG syntax into presentation of required markup
    • From: "Per Sennels" <per.sennels@s...>
  • Re: Transformation of RelaxNG syntax into presentationof required markup
    • From: Jirka Kosek <jirka@k...>
  • Re: Transformation of RelaxNG syntax into presentationof required markup
    • From: Rick Jelliffe <rjelliffe@a...>
  • Re: Transformation of RelaxNG syntax into presentationof required markup
    • From: Jirka Kosek <jirka@k...>
  • RE: Transformation of RelaxNG syntax into presentation of required markup
    • From: "Michael Kay" <mike@s...>