Documentation Bug 630652 created to install Guide update for Other Assets

[Thomas Bullock]

> -----Original Message-----
> From: Yawar Amin [mailto:yawar.amin at gmail.com]
> Sent: Monday, September 27, 2010 11:08 PM
> To: Yawar Amin
> Cc: Thomas Bullock; gnucash-devel (gnucash-devel at gnucash.org)
> Subject: Re: Documentation Bug 630652 created to install Guide update
> for Other Assets
> 
> Hi Tom,
> 
> OK, slight change of plans: I've just gone ahead and committed your
> patch into the docs repository [1], and then made some very simple
> cosmetic changes on top of that [2]. I'm working on some more changes
> that I will post here so you can have a look and see if it seems OK.
> Basically a little tweaking of sentences here and there, and then a few
> markup changes to take advantage of DocBook's features.
> 
> The plan after that is to backport these commits to the 2.2 branch,
> since everything you've written applies there as well.
> 
> For now, you can get a very good view of all changes made by following
> the referenced links. Trac (the software that runs this diff view) is
> especially great in that it shows you changes that have been made
> within a line, like deleting a single Space character.
> 
> Regards,
> 
> Yawar
> 
> [1] http://svn.gnucash.org/trac/changeset/19618
> [2] http://svn.gnucash.org/trac/changeset/19619

[<Tom:>] Yawar,  thanks for all  the attention you have paid to this patch of mine.  I just now got caught up with your previous emails connected with my patch and also trac changesets 19618 and 19619.  I now have these questions/comments:

1.  Where do I learn how to use Trac?  Its output is excellent when showing clearing the differences between two items.

2.  I suppose in learning how to use Trac I will learn how to integrate several modules into one output file.  If not, how do I do that?

3.  What happens in XML or HTML when trailing spaces are not removed?  It clearly is important or you would not have spent the effort.

4.  How does trac detect the presence of spaces in one module and not the other?  If you removed the unwanted spaces, how did you disclose them in order to remove them?

5.  thanks for calling to my attention these XML proper treatments: &rsquo;, &dash;, and <quote>...</quote>

6.  I found two errors that I had not caught previously: one is a spelling error; the other is a sequence of tenses error.  Since you have promoted my modules, when would be the proper time to correct those by making another patch.  I assume it would be after you get done promoting my changes to 2.2 as well as the trunk.  Is that correct?  If so, when will that likely be?  If not correct, what is your recommendation?

Thanks again for your very careful review of my patch.  

Other Issue:  Still working on my description of what is needed in the sequence of steps for newcomers participating in the documentation effort.  Per John Ralls advice, I will put that in the wiki and let others know when that happens.

Best,

Tom