<div dir="ltr">Re: documentation.<br><br>It was originally suggested at the April meeting that we could use Scribus and that we may have a presentation on it. Obviously that hasn't happened. Does anyone know enough about Scribus to be willing to do that? I know nothing about Scribus at all, so I can offer no advice on whether or not it would be apt.<br>
<br>After Julia's Latex talk someone suggested we could use Latex for the documentation as Latex documents can easily be converted into other formats, whether it be help files for an application, xml, html, a book, etc. The problem we discovered with Latex was that it will present a barrier to some of the less technical members of the group and it's something people have to learn. We're also left with the question of how to manage the Latex files between the group. If we have to store the Latex files in a CVS or SVN repository then that presents yet another barrier and another learning curve making this option less than ideal - especially once you consider that it's more likely that the less technical members of the group may be the most willing to write accurate and detailed documentation.<br>
<br>Of course we are also left with the option of a Wiki, which is open to all and manages itself. It certainly seems like the lazier and probably most open option so therefore it's the one I support at the moment (subject to information about Scribus!).<br>
<br>Karl<br><br><br><div class="gmail_quote">2008/7/26 Mike Evans <span dir="ltr"><<a href="mailto:mike@tandem.f9.co.uk" target="_blank">mike@tandem.f9.co.uk</a>></span><br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
Ritchie,<br>
<br>
We should have come back to your mail to say that there was a confusion with the room booking at the school in Dover. (Anyone recommend them a good open source resource reservation system?) As a result Colin did a quick re-organisation to an alternative venue and we will have to pick up the Karochi documentation at a later date.<br>
<br>
The initial intention was to see Karochi in use, and work out how we could divide up the task of producing some useful documentation. I was going to suggest to Colin that we might start thinking of ways to do that with a virtual meeting. However I was unable to get to today's meeting, so here goes:<br>
<br>
1) Suggestions on how we produce the documentation as responses to this thread please. My starter thought is that we make use of our lab server at <a href="http://www.kentlug.org" target="_blank">www.kentlug.org</a>, perhaps by installing either a document repository or a wiki. This could initially hold things like our plan:- who's doing what etc, but also the initial output. That output could then be converted as a second stage into the formal documentation.<br>
<br>
2) After a respectable interval - say two weeks from now I'll review all the feedback and put together an agenda for a virtual meeting.<br>
<br>
3) Following the virtual meeting I'll try to produce a summary/minutes and some sort of plan of action.<br>
<br>
4) At some point, as part of the plan we will re-schedule the demonstration we had hoped to have this weekend.<br>
<br>
Right - now I'll take my project manger hat off.<br>
<br>
Mike<br>
<br>
Ritchie Fraser wrote:<br>
<blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;"><div>
Hi Guys (and Gals),<br>
<br>
Lurker, de-lurking again.<br>
<br>
Just like to say that I saw the KLUG write-up in Linux Format magazine (page 14). Even though I haven't made it to a meeting in quite some time. <br>
I am Chair of Governors at my daughters Primary School and am very interested in projects like Karoshi and I would like to contribute to the documentation project. My meeting attendance has been sporadic and I can't see this changing (life-style issues, see Schol Gov bit above!). <br>
Do you have a FAQ about the project? Does it include...<br>
Is a list of required documentation pages / chapters / whatever be posted on the KLUG website? What format is required OpenDoc / html / other. Is an install of Karoshi needed?<br>
<br>
<br>
<br></div>
------------------------------------------------------------------------<br>
<br>
_______________________________________________<br>
Kent mailing list<br>
<a href="mailto:Kent@mailman.lug.org.uk" target="_blank">Kent@mailman.lug.org.uk</a><br>
<a href="https://mailman.lug.org.uk/mailman/listinfo/kent" target="_blank">https://mailman.lug.org.uk/mailman/listinfo/kent</a><br>
</blockquote>
<br>
_______________________________________________<br>
Kent mailing list<br>
<a href="mailto:Kent@mailman.lug.org.uk" target="_blank">Kent@mailman.lug.org.uk</a><br>
<a href="https://mailman.lug.org.uk/mailman/listinfo/kent" target="_blank">https://mailman.lug.org.uk/mailman/listinfo/kent</a><br>
</blockquote></div><br></div>