Developing the documentation

[Spel]

Dave Herman a écrit :
> On Wed, 2007-02-14 at 12:19 +0000, Leom Burke wrote:
>   
>>     Hi Guys,
>> I am new to using gnucash and find it fantastic and i want to help
>> improve the project.
>> I am planning on working on the documentation to improve it for other
>> new users.  I have the SVN trunk for the docs but the XML does not seem
>> to be standardised - no tabs and the tags dont line up in any editor.
>>     
>
> When the update to the "Tutorial & Concepts Guide" occurred last
> "spring" (Northern Hemisphere) there was an effort to standardize the
> format somewhat.  The format of the XML doesn't really impact the user's
> view of the document.  I think that both (T&C Guide and Help) are
> displayed using YELP.
>
>   
>> I would like to tweak the code slightly to improve the readability for
>> new contributors by tabbing the tags properly...etc.  As this is a
>> rather large task i am asking if anyone minds me doing it first :).  I
>>     
>
> I'm currently working on a significant re-work of the Help document, and
> would welcome any assist/review available. I am leaving for a "long
> weekend" so will be off-line until early next week.
>
>   
I've just started translating the "Getting Help" and "Getting Started"
sections of the  GnuCash Help, so I am interested to view revised
versions of those. May be I should hold on translation?

I do not know very much about XML format, but I would like to let you
know of a little problem I had.  Using xml2po, I could not convert the
gettingstrarted.xml until I split it in two, leaving only one chapter in
each the two .xlm modified files. My intent was to put the two chapters
back into only one file after complete translation, or before
transmitting for comments.
> I sure Chris would welcome any "updates".
>
> There are some "guidelines" in the wiki, I think, if note I look for
> what Bengt Thuree, and I used on the T&C Guide.
>
> Dave
>
>   
>> would then start a page-by-page analysis of the documentation as it
>> appears to be something that gets overlooked by the developers (i didn't
>> mean to offend anyone then) and needs someone to take stock and ensure
>> that it is fully up to date and flows correctly.
>>
>> Thanks,
>>
>> Leom
>> _______________________________________________
>> gnucash-devel mailing list
>> gnucash-devel at gnucash.org
>> https://lists.gnucash.org/mailman/listinfo/gnucash-devel
>>     
>
> _______________________________________________
> gnucash-devel mailing list
> gnucash-devel at gnucash.org
> https://lists.gnucash.org/mailman/listinfo/gnucash-devel
>
>