[Koha-devel] Merging of 'install Koha on Debian and Ubuntu' wiki pages

[Mason James]

i think the best idea is that the various Koha installation guides get consolidated into a new project, following the workflow of the 'Koha manual' project
https://gitlab.com/koha-community/koha-manual

it's critical that the installation doco is correct and up to date, and an elected group of people would help achieve that goal

if people are interested in improving the installation documentation, they can join the project or send a patch

good idea?


fyi: for comparison, here are the debian and ubuntu install guides for wordpress  (the wordpress installation procedure is very similar to koha)
https://wiki.debian.org/WordPress
https://ubuntu.com/tutorials/install-and-configure-wordpress <https://ubuntu.com/tutorials/install-and-configure-wordpress#5-configure-wordpress>



On 10/07/20 11:45 am, dcook at prosentient.com.au wrote:
>
> Maybe it’s worthwhile keeping 2 separate pages but divide them not by OS but rather by difficulty. I think DSpace does this or used to do it.
>
> For example:
>
>  1. Quick Start Installation
>  2. (Beginner) Installation
>
> The “Quick Start” would be the current Debian one perhaps, and then the Ubuntu one could be modified into the longer “Beginner” user-friendly one.
>
> I don’t have any strong feelings on this, but just a thought.
>
> David Cook
>
> Systems Librarian
>
> Prosentient Systems
>
> 72/330 Wattle St
>
> Ultimo, NSW 2007
>
> Australia
>
> Office: 02 9212 0899
>
> Online: 02 8005 0595
>
> *From:*Koha-devel <koha-devel-bounces at lists.koha-community.org> *On Behalf Of *Mark Tompsett
> *Sent:* Friday, 10 July 2020 5:06 AM
> *To:* Mason James <mtj at kohaaloha.com>; Koha Devel <koha-devel at lists.koha-community.org>
> *Subject:* Re: [Koha-devel] Merging of 'install Koha on Debian and Ubuntu' wiki pages
>
> Greetings,
>
> Installation needs to be simple, and I'm worried a consolidation may make it more complex (or lack detail) for novice users who just want to try it out to see if it meets their needs.
>
> The Ubuntu page was fashioned with the notion of "cut-and-paste" without much thinking.
>
> The Debian page requires more understanding and thought.
>
> While I am not against consolidating the pages, I have problems with the expectation bar for installation that a lot of people need to leap. The consolidated page should have pretty boxes that if you do those commands without much reading (sadly some is required), it will just work.
>
> And while the Ubuntu page is longer, perhaps breaking parts out to sub-pages may be a way to shrink it to the Debian page preferred size?
>
>
> Is there a way to know which page is accessed more often and where? That may also inform how we re-work those pages into one.
>
> Just some thoughts. Thanks for asking for input, Mason James.
>
> GPML,
>
> Mark Tompsett
>