New Documentation Bug
Frank H. Ellenberger
frank.h.ellenberger at gmail.com
Mon Jan 30 14:51:37 EST 2017
Hi,
Am 30.01.2017 um 18:25 schrieb Geert Janssens:
> Op maandag 30 januari 2017 21:35:20 CET schreef David T.:
>> It occurs to me, though, that John’s comments regarding possible repackaging
>> for the Mac make me wonder more generally whether information that is
>> intended to be short term (such as this) really belongs in the
>> documentation. I am reminded of the What’s New section, which was recently
>> removed from the Guide in acknowledgement of the website being a better
>> location for this. Temporary transitory information such as this is a poor
>> fit in the documentation, as it either forces some person to monitor and
>> change the information all the time (which is a challenge), or it ends up
>> being dated and misleading to users.
>>
> This took me by surprise. I didn't see any mention of John's intentions to
> change this. Had to dig back in the archives to find this indeed buried in the
> "Change storage format of existing data" thread, which I admit to have skimmed
> only before due to time restraints. That's good news of course!
>
>> I do not know what the best solution in this broader situation is; I am open
>> to suggestions. In the meantime, I will see whether I can work out language
>> that both addresses the issue and mitigates the editorial burden.
>
> Well, current documentation is for the 2.6 release in which the sql backend on
> OSX only supports sqlite. So that's the information which should be in the 2.6
> docs. I believe this can be one short note at the spot where you explain which
> sql types are supported. It doesn't need much elaboration.
>
> If John does find the time to fix this for 2.8 (which I surely hope!), the
> accompanying documentation needs an update. The trick will be to remember at
> that point this needs updating...
>
> Alternatively you can hold off the PR for this piece of information until it
> will be more clear whether or not this will happen for 2.8.
>
> I can't think of better options ATM.
>
> Geert
In the wiki I would write something like "Since version 2.x.y the Quartz
package includes SQLite support."
Frank
More information about the gnucash-devel
mailing list