[GNC-dev] Main WIki Page edit

[Adrien Monteleone]

In combination with making the T&CG glossary sentence a part the Official documentation paragraph, I think the second sentence should be moved down to the Developer Documentation paragraph.

Also, the following line needs a number correction:

"The Documentation page on the gnucash.org website also contains ~~this~~ _these_ documents in”

I’d do either myself, but I see the main page is above my pay grade. (I’m sure for very good reason)

Regards,
Adrien

> On Aug 18, 2018, at 8:53 AM, John Ralls <jralls at ceridwen.us> wrote:
> 
> 
> 
>> On Aug 17, 2018, at 11:45 PM, David T. via gnucash-devel <gnucash-devel at gnucash.org> wrote:
>> 
>> 
>> 
>>> On Aug 17, 2018, at 11:29 AM, Frank H. Ellenberger <frank.h.ellenberger at gmail.com> wrote:
>>> 
>>> Am 16.08.2018 um 20:37 schrieb David T. via gnucash-devel:
>>>> Hello,
>>>> 
>>>> I was reviewing the Wiki today to try to figure out where a page on the SQL formats might get attached, and I noticed a change to the Glossary section that makes for awkward English.
>>>> 
>>>> As currently entered, the section reads:
>>>> 
>>>> Above GnuCash Tutorial and Concepts Guide includes a comprehensive Glossary: [https://www.gnucash.org/docs/v2.6/C/gnucash-guide/gnc-gloss.html Released] or [https://code.gnucash.org/docs/C/gnucash-guide/gnc-gloss.html Maintainer] version.
>>>> 
>>>> However, it used to say:
>>>> 
>>>> The GnuCash Tutorial and Concepts Guide includes a comprehensive Glossary: [https://www.gnucash.org/docs/v2.6/C/gnucash-guide/gnc-gloss.html Released] or [https://code.gnucash.org/docs/C/gnucash-guide/gnc-gloss.html Maintainer] version.
>>>> 
>>>> I would like to ask that someone with edit permissions on the wiki home page to please change the word “Above” back to “The” to make the section read more idiomatically.
>>>> 
>>>> David T.
>>> 
>>> IMHO it is also bad style to have:
>>> The Tutorial and Concepts Guide - an in-depth guide to the concepts.
>>> :
>>> The GnuCash Tutorial and Concepts Guide includes a comprehensive
>>> Glossary: Released or Maintainer version.
>>> 
>> 
>> We differ in our opinion here. I stand by my recommendation.
> 
> And you’re both right, it needs a more thorough rewrite to flow better. Since the glossary isn’t a stand-alone document it shouldn’t have its own level-two header. An additional sentence in the T&CG paragraph under Official Documentation would be better. On the other hand the wiki needs more prominence, there’s a whole lot more information there than just the FAQ and technical glossary.
> 
> Regards,
> John Ralls
> 
> _______________________________________________
> gnucash-devel mailing list
> gnucash-devel at gnucash.org
> https://lists.gnucash.org/mailman/listinfo/gnucash-devel