[GNC-dev] Documentation sources since 8 years moving from guide to help

[Frank H. Ellenberger]

Hi Stefan,

Am 12.04.2018 um 07:52 schrieb Stefan Mueller:
> thanks for the information. I might find the time to adapt the removed page
> as it was very helpful to me and should return to the documentation, but
> updated to new interface.
> 
> 2018-04-11 19:06 GMT+02:00 Geert Janssens <geert.gnucash at kobaltwit.be>:
> 
>> Op woensdag 11 april 2018 16:09:57 CEST schreef Stefan Mueller:
>>> Hallo,
>>> I the course of my researches in regard to *Import Map Editor* I've
>> noticed
>>> that there are two branches of documentation, *stable
>>> <https://www.gnucash.org/docs/v3/>* and *git <
>> https://cvs.gnucash.org/docs>*
>>> and that there are some lonely help docs. on *git*: 2.7. Daten
>> importieren
>>> <https://cvs.gnucash.org/docs/de/gnucash-guide/basics-import1.html> what
>>> shall go into the official documentation.
>> What you are looking at are the html translation of our documentation. It's
>> not the version managed documentation source though.
>>
>> That is written in docbook format and stored here:
>> https://github.com/Gnucash/gnucash-docs/
>>
>> The specific page is a relic of documentation that got removed from the
>> documentation sources in 2015 by Mechtilde in this commit:
>> https://github.com/Gnucash/gnucash-docs/commit/31d724b34ceaa98d7aa29
>>
>> The html page should not have been there anymore and is a heads up we
>> should
>> update our nightly documentation build to clean out obsolete files.
>>
>> However in this case it's nice you found it and it triggers you to
>> re-enable
>> it.
>>> In order to do so I would have to clone the documentation repository and
>>> reorder the html files and reset the links and commit it.
>> Not exactly. You'd have to translate the html pages back into docbook
>> format
>> and update them to reflect current stable. The importer (particularly the
>> csv
>> one) has changed since that documentation was written.
>>
>> It's probably easier though to search for the original docbook source in
>> git
>> history and start from there.

The english part was removed in
git-svn-id: svn+ssh://svn.gnucash.org/repo/gnucash-docs/trunk@19948 -
Related to bug#635357 Remove QIF assistant description and move New
Account Hierarchy setup description.

as part of https://bugzilla.gnome.org/show_bug.cgi?id=635357 - New "Save
As..." and "Open..." dialogs undocumented
It should hove gone from guide to "a new Help 3.2, before the current
one." [Comment 9]

But it never arrived ...

>> I have quickly searched the current documentation sources and it appears
>> there
>> is no information on importing either in the English documentation. That's
>> likely why it got removed from DE at some point as the English version is
>> considered the primary documentation and the other languages are 'only'
>> translations. (Though that may not necessarily be the right approach)
>>
>>> Once I have finalized all that, I will notify the developer team of your
>>> changes, either by creating a pull request
>>> <https://wiki.gnucash.org/wiki/Git#Pull_Requests> (pulls my clone into
>>> master), or by creating and uploading a patch
>>> <https://wiki.gnucash.org/wiki/Preparing_A_Documentation_Patch>.
>> Indeed.
:

for the english part, you might already now send a notice to
https://bugzilla.gnome.org/show_bug.cgi?id=303164 - Documentation for
online banking Options
to reduce duplicate work.