[GNC-dev] Documentation update problems

[John Ralls]

It’s Debian and derivatives: Ubuntu is a derivative--or these days maybe a symbiote, there are Canonical reps on the Debian board--of Debian.

I frankly don’t understand why Ubuntu needs a per-release explanation of how to build it, especially since Debian doesn’t. `sudo apt-get build-dep gnucash` installs everything you need to build 2.6; there are a few additional packages (cmake, ninja, swig, xsltproc, libgtk-3-dev, libboost-all-dev, googletest, and libwebkit2gtk-3.0-dev) to build 3. After that it’s the same directory creation, clone gnucash.git, cmake, and ninja reqardless of distro version.

Regards,
John Ralls


> On Sep 18, 2018, at 6:52 PM, David Cousens <davidcousens at bigpond.com> wrote:
> 
> On Tue, 2018-09-18 at 11:18 -0500, Adrien Monteleone wrote:
>>> On Sep 18, 2018, at 7:53 AM, Frank H. Ellenberger <frank.h.ellenberger at gmail.com> wrote:
>>> 
>>> 
>>> Perhaps you can do some cleanup: Is Gutsy outdated?
>> 
>> That was version 7.10 of Ubuntu, that is, released October 2007. By far, it is no longer supported by Canonical.
>> (wasn’t even a Long Term Support release) And there is not even a hardware reason that anyone should be running it. I
>> don’t even think the repos for it are even available any longer.
>> 
>> The oldest supported Ubuntu version is 14.04 (and then only until next April) I shouldn’t think any build instructions
>> are necessary (unless in an archived page if desired) for anything older than this.
>> 
>>> 
>>>> The main building page is a massive tome. I did start breaking out some
>>>> parts of it into smaller logical chunks when I updated the BuildUbuntu16.04
>>>> ( which covers 16.04, 18.04 and Linux MInt 18 and 19 in effect.). 
>>> 
>>> Shouldn’t it be renamed to BuildUbuntu then?
>> 
>> I agree, the link text/page title is confusing and there have already been questions about what instructions to use
>> for building on 18.04.(yes, I see that it says this is for 18.04 as well, but clearly someone didn’t or they wouldn’t
>> have asked)
>> 
>> If replacing content with a link to a dedicated page is desired practice for cleaning up the wiki, then I’d propose
>> all of the material for building on Ubuntu be moved to that page, that it be renamed simply BuildUbuntu and that the
>> main build page be left with a link to it for the Ubuntu section. As it is, the original build page still contains
>> long outdated info. I would have instead expected to see the most current instructions there and then maybe a link for
>> older versions.
> 
> Adrien ,John
> 
> I too think the break out from that main page  could be better structured and the BuildingUbuntu16.04 renamed something
> like BuildingUbuntu&Derivatives. I had intended to address that after rewriting the BuildUbuntu16.04 but ended up
> distracted with other priorities. 
> 
> Also the main page could perhaps have a one line breakout to a Building on Linux page. The page name as long as it is
> descriptive to some extent is less important than the information in the link specifying what it links to e.g.
> [[BuildingUbuntu&Derivatives | Building on Ubuntu 16.04, 18.04 and Linux Mint]]. Despite this I think it is important to
> get to the information the user will actually use in the minimum number of steps. Wiki navigation can be  dodgy at
> times. I would propose a link to the at least the general Building page somewhere on the wiki entry point page might
> help achieve that given John's comment and info in another post on searching of wiki pages.
> 
> David Cousens
>> 
>> Along with that, if older material for older systems and versions isn’t going to be moved to its own ‘archive’ page,
>> then it should always appear down the page in chronological order. The current state of the build instructions is a
>> bit messy in that regard.
>> 
>> Regards,
>> Adrien
>> _______________________________________________
>> gnucash-devel mailing list
>> gnucash-devel at gnucash.org <mailto:gnucash-devel at gnucash.org>
>> https://lists.gnucash.org/mailman/listinfo/gnucash-devel <https://lists.gnucash.org/mailman/listinfo/gnucash-devel>
> _______________________________________________
> gnucash-devel mailing list
> gnucash-devel at gnucash.org <mailto:gnucash-devel at gnucash.org>
> https://lists.gnucash.org/mailman/listinfo/gnucash-devel <https://lists.gnucash.org/mailman/listinfo/gnucash-devel>