Merging of 'install Koha on Debian and Ubuntu' wiki pages
hi Folks i think it would be a good idea to merge the 2 following wiki pages... https://wiki.koha-community.org/wiki/Koha_on_Debian https://wiki.koha-community.org/wiki/Koha_on_ubuntu_-_packages my reasoning is that the procedure to install Koha on both Debian and Ubuntu (using .deb packages) is now identical currently each page has the same information - but presented differently, with inconsistencies what would be best is a single page that has consistent information for installing Koha on both operating systems any thoughts?
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
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@lists.koha-community.org> On Behalf Of Mark Tompsett Sent: Friday, 10 July 2020 5:06 AM To: Mason James <mtj@kohaaloha.com>; Koha Devel <koha-devel@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
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@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@lists.koha-community.org> *On Behalf Of *Mark Tompsett *Sent:* Friday, 10 July 2020 5:06 AM *To:* Mason James <mtj@kohaaloha.com>; Koha Devel <koha-devel@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
participants (3)
-
dcook＠prosentient.com.au -
Mark Tompsett -
Mason James