Hi. I was just wondering what documentation is available for Koha, and if it would be possible to keep track of it in some unified place on koha.org. It just occurred to me today that many of the questions people have could be answered or handled by online documentation, especially if it included HOWTOs for common tasks and a good index of available info. ... And koha.org has no documentation section. At the very least, koha.org should probably have a "Documentation" tab along with its other main navigation, and its /doc/ directory should provide links to all known sources of useful Koha info. I managed to find a Koha wiki, but it is far from obvious that it exists, or is used. What sort of wiki is it? Who runs it? Does it use any sort of version control? Does anyone review it to keep it organized and accurate? Does anyone import outside articles into it, to keep things unified and accessible? -- Scott
Scott et al... The repository you've requested exists and is in fact having material migrated to it. A second wiki, which supports DocBook XML and which was graciously installed and hosted by Mike Reavey at http://mreavey.homeip.net:9673/book-0.5/index.php It is now open for business (perhaps a little raw-er in form than I'd like, but this is the second or third query to the general public). I have been migrating the "good stuff" that Steve Hedges (who I owe several at this point).... Much of the delay in getting something out to 'officially' replace the now overcome-by-events www.koha.org/manual material is my fault. Life has been, in the great tradition of Koha contributors, a trifle hectic. Feel free to castigate me, I've been slack and deserve to hear it. If you're interested in contributing (there are some wrinkles to be aware of) please drop me a line. My hope with this email (a) some folks will once again volunteer [hint: email me!] to take something messy on (as always, thanks to HLT, Regula, Patricia, etc who got us to this point) and (b) the end result will successfully combine both the material out there and some additional stuff and (c) Koha2 will eventually have as useful a docs set as Koha1.x came to have. Nick Your (blast from the past) docs slave.
* Nicholas S. Rosasco <nsr@etome.net> wrote:
The repository you've requested exists and is in fact having material migrated to it.
A second wiki, which supports DocBook XML and which was graciously installed and hosted by Mike Reavey at http://mreavey.homeip.net:9673/book-0.5/index.php
Ah... Zope. Or perhaps not zope. Is that running phpWebApp on the zope management port? Is there direct collaboration between the two wikis, to execute a full migration? What are the reasons behind the switch? It's good to see that progress is being made, but it does still seem pretty rough around the edges. I notice, on that site, no way to edit the content, or to log in. ... or contact the maintainer of the site. Some of the links are not very noticable, either, since different links use different styles. (some links are brownish and underlined, others are blue and non-underlined, others are bold green and non-underlined, and it took a while to realize the green ones were links) -- Scott
I'm replying to Scott off list, since my blather on this topic is (presumably) not of interest to anyone and may become an extended conversation. If there is a desire for this to return to the list (or someone wants to join the "branched" flow) please drop me a line... Nick ...trying to limit the koha@katipo list to, well, Koha specific vs project blarney. -----Original Message----- From: Scott Scriven [mailto:koha-main@toykeeper.net] Sent: Monday, August 23, 2004 10:20 PM To: koha@lists.katipo.co.nz Cc: nrosasco@acm.org Subject: Re: [Koha] documentation * Nicholas S. Rosasco <nsr@etome.net> wrote:
The repository you've requested exists and is in fact having material migrated to it.
A second wiki, which supports DocBook XML and which was graciously installed and hosted by Mike Reavey at http://mreavey.homeip.net:9673/book-0.5/index.php
Ah... Zope. Or perhaps not zope. Is that running phpWebApp on the zope management port? Is there direct collaboration between the two wikis, to execute a full migration? What are the reasons behind the switch? It's good to see that progress is being made, but it does still seem pretty rough around the edges. I notice, on that site, no way to edit the content, or to log in. ... or contact the maintainer of the site. Some of the links are not very noticable, either, since different links use different styles. (some links are brownish and underlined, others are blue and non-underlined, others are bold green and non-underlined, and it took a while to realize the green ones were links) -- Scott
Scott Scriven said:
It just occurred to me today that many of the questions people have could be answered or handled by online documentation, especially if it included HOWTOs for common tasks and a good index of available info. ...
www.koha.org/wiki has a section called "Documentation" and a link to "Online Help." While this is a work-in-progress (it is a wiki, after all), many of the recurrung question about authorities, MARC tag structure, etc., can be answered with a little digging there. Stephen -- Stephen Hedges Skemotah Solutions, USA www.skemotah.com -- shedges@skemotah.com
* Stephen Hedges <shedges@skemotah.com> wrote:
www.koha.org/wiki has a section called "Documentation" and a link to "Online Help." While this is a work-in-progress (it is a wiki, after all), many of the recurrung question about authorities, MARC tag structure, etc., can be answered with a little digging there.
I've spent the last day or so playing with that wiki, adding things, etc. It does seem like a good source of information, capable of answering many questions. However, I would not know that it exists, if I were to go to koha.org or look through the koha tarball. I suppose my suggestion is this: Someone should put a link from koha.org, in the template (probably the menu at the left) called "Documentation" or something similar, which points to the wiki. In addition, the FAQ on koha.org and the two FAQs in the wiki should probably be unified and the FAQ link on koha.org should point to it. Does this sound reasonable? -- Scott
Hi
I suppose my suggestion is this: Someone should put a link from koha.org, in the template (probably the menu at the left) called "Documentation" or something similar, which points to the wiki. In addition, the FAQ on koha.org and the two FAQs in the wiki should probably be unified and the FAQ link on koha.org should point to it. Does this sound reasonable?
An excellent suggestion, I'm thinking of making some other changes to the Koha Website so if anyone else has ideas then now would be an excellent time to send them through:-) Cheers Rachel
Scott Scriven said:
I suppose my suggestion is this: Someone should put a link from koha.org, in the template (probably the menu at the left) called "Documentation" or something similar, which points to the wiki.
Actually, the "online help" in the wiki is just a workspace. As I understand it, all of that stuff will actually be available "online" by clicking on help buttons in version 2.2. In other words, it will be included in the code, and there will be no need to leave your library site to get to the documentation. Stephen -- Stephen Hedges Skemotah Solutions, USA www.skemotah.com -- shedges@skemotah.com
participants (4)
-
Nicholas S. Rosasco -
Rachel Hamilton-Williams -
Scott Scriven -
Stephen Hedges