Hello, Can anyone give me clear language on when and why a documentation creator would need to reissue the commands in Initializing Documentation Build Environment? I’d like to clear this issue up on the wiki before it gets lost.
David > On Sep 14, 2018, at 10:21 AM, David T. <sunfis...@yahoo.com> wrote: > > Frank, Geert, > > I am finally following up on this thread, and I’d like to note that the > information that Frank says “got lost,” and which Geert has re-entered on > this page were actually moved to a different page > (https://wiki.gnucash.org/wiki/Initializing_Documentation_Build_Environment > <https://wiki.gnucash.org/wiki/Initializing_Documentation_Build_Environment>) > and the reference to this information was moved up to Section 2. Setting Up > Your System. > > Here we have an example of how duplicative information ends up in our > ecosystem! > > For the future, we should change the Documentation Update Instructions in > this section to point instead to the separate page set up for it. However, > there needs to be a clear instruction here as to why a user might need to > re-prepare their build environment. I, for one, have no idea why my build > environment was broken. I had already followed those directions previously > (as evidenced by the existence of the build folder structure on my system), > so what broke them? I imagine something along the lines of: > > “If you have not built the documentation before, or if you {have changed some > miniscule aspect of your system | are incompetent like David T.}, it is > usually necessary to reconfigure your build environment as outlined in > Initializing Documentation Build Environment.” > > Cheers, > David > >> On Aug 17, 2018, at 3:25 PM, Frank H. Ellenberger >> <frank.h.ellenber...@gmail.com <mailto:frank.h.ellenber...@gmail.com>> wrote: >> >> Am 17.08.2018 um 09:18 schrieb Geert Janssens: >>> Op vrijdag 17 augustus 2018 08:41:05 CEST schreef David T. via >>> gnucash-devel: >> : >> >>>> I’m not sure why there’s a “missing” in the initial command, and I don’t >>>> know where config.guess is supposed to be—and I won’t even try to guess. >>>> >>>> I would love to have some guidance. >>>> >>> >>> I went to look at the wiki page and unfortunately it's incomplete. You get >>> this error because a few essential commands have been omitted. >>> >>> I have added a section that should fill the gap. Can you proofread this: >>> https://wiki.gnucash.org/wiki/ <https://wiki.gnucash.org/wiki/> >>> Documentation_Update_Instructions#Prepare_The_Build_Directory >>> And report back any issues you experience ? >>> >>> It's written these steps are usually done early in in the set up process, >>> but >>> you can still run them right now and then retry the validation. >>> >>> Geert >> >> Yeah, the missing section got lost in >> https://wiki.gnucash.org/wiki/index.php?title=Documentation_Update_Instructions&type=revision&diff=13215&oldid=12785 >> >> <https://wiki.gnucash.org/wiki/index.php?title=Documentation_Update_Instructions&type=revision&diff=13215&oldid=12785> >> >> OTOH it was a major improvement of the readability. >> >> Regards >> Frank >> > _______________________________________________ gnucash-devel mailing list gnucash-devel@gnucash.org https://lists.gnucash.org/mailman/listinfo/gnucash-devel
