[Koha-devel] Idea for Koha documentation -- move sysprefs into an appendix

[Chris Cormack]

We are working on this, the first section is now about the installer.

https://koha-community.org/manual/17.05/html/

It goes through web installer, then onboarding tool, before the Admin,
but yes, we could move the admin section down. You can either send a
patch, or do that in gitlab and send a merge request.

(Will be for 17.11, not changing the structure of 17.05 now :) So make
changes on the master branch)

Katrin has written a page, with sphinx and gitlab the barrier should be
much easier, Im hoping the doc manager role is more and more that,
managing, not authoring.

https://wiki.koha-community.org/wiki/Editing_the_Koha_Manual

Chris


On 11/07/17 08:49, Barton Chittenden wrote:
> I've been wondering for a while if it would be a good idea to move the
> administration section farther back in the manual. As it stands, a new
> user, first reading through the manual will read through a page or two
> of introduction, and then get thrown straight into 600+ system
> preferences. I'm coming up on four years working with Koha, and I
> *almost* feel equipped to read through all of those, end-to-end.
>
> Of course no-one actually reads the manual that way; we tell people to
> browse the table of contents and cherry pick the parts that they find
> the most interesting, and expand their knowledge from there -- but
> maybe we could provide a friendlier more intuitive introduction which,
> pre-supposes that a reader is sitting in front of a system that is
> configured with some sane default settings, and gives a tour of Koha's
> features? That seems like a much friendlier approach.
>
> Just my two cents,
>
> --Barton
>
>
> _______________________________________________
> Koha-devel mailing list
> Koha-devel at lists.koha-community.org
> http://lists.koha-community.org/cgi-bin/mailman/listinfo/koha-devel
> website : http://www.koha-community.org/
> git : http://git.koha-community.org/
> bugs : http://bugs.koha-community.org/

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.koha-community.org/pipermail/koha-devel/attachments/20170711/9e3686b7/attachment.html>