Greetings,
will the RST be made available as text [snip]
to allow copy/paste of cli lines using vi (or whatever) during the
install process?
The tarball will have Git installation method instructions for Ubuntu. After
all,
if you are doing a packages installation, you will not have an
On 2012-09-15, at 1:22 AM, Paul wrote:
At 03:00 PM 9/14/2012 +1200, Mason James wrote:
On 2012-09-13, at 2:30 PM, Mark Tompsett wrote:
Greetings,
[snip]
Re: proposal for use of a standard for documentation (RST)
-- Don't care about the format. But I like standards. Standards clarify
On 2012-09-15, at 3:35 AM, Mark Tompsett wrote:
Greetings,
will the RST be made available as text [snip]
to allow copy/paste of cli lines using vi (or whatever) during the
install process?
The tarball will have Git installation method instructions for Ubuntu. After
all,
if you are
On 2012-09-13, at 2:30 PM, Mark Tompsett wrote:
Greetings,
[snip]
Re: proposal for use of a standard for documentation (RST)
-- Don't care about the format. But I like standards. Standards clarify and
guide. Standards are good.
[snip]
2/ mark old/obsolete doco as *WARNING -
Greetings,
[snip]
Re: proposal for use of a standard for documentation (RST)
-- Don't care about the format. But I like standards. Standards clarify and
guide. Standards are good.
[snip]
2/ mark old/obsolete doco as *WARNING - DEPRECIATED*, and redirect to new
doco location
(...or just
Greetings,
[snip]
finally... I'm volunteering to be Koha's 'installation doumentation'
manager
a new role, similar to Nicole's 'documentation manager' role, but focusing
on Koha's installation documentation only
+1
I think this role is necessary so that installation documentation can be
Le 10/09/2012 06:18, Mason James a écrit :
after a process of elimination, RST was a pretty clear winner, why?
Hi Mason,
I'm not sure I understand well what you're proposing here : write the
install doc in RST ? rewrite all the doc (including Nicole one) ?
Thx for clarifying my cloudy brain ;-)
Hi Mason,
so these 2 wiki docs...
http://wiki.koha-community.org/wiki/Debian
http://wiki.koha-community.org/wiki/Koha_on_Ubuntu
convert to these 2 RST docs...
http://pub.kohaaloha.com/kohadocs-sphinx/debian.html
http://pub.kohaaloha.com/kohadocs-sphinx/ubuntu.html
the docs look
Mason James schrieb am 10.09.2012 10:23:44
ok, so a little late... but some very successful news… :)
[…]
Looks very nice, thank you for taking the time to do this evaluation!
finally... I'm volunteering to be Koha's 'installation
doumentation' manager a new role, similar to Nicole's
On 2012-09-10, at 8:00 PM, Paul Poulain wrote:
Le 10/09/2012 06:18, Mason James a écrit :
after a process of elimination, RST was a pretty clear winner, why?
Hi Mason,
I'm not sure I understand well what you're proposing here : write the
install doc in RST ?
yep, basically thats it :)
Salvete!
(...or just delete the old doco)++
Don't pick this option. Warn instead.
(http://en.wikipedia.org/wiki/Category:User_warning_templates)
As someone with deprecated documentation, on the few occasions when I
return to clean things up, I count on my old doc being there as
On 2012-08-28, at 8:18 AM, Mason James wrote:
On 2012-08-24, at 7:27 AM, Robin Sheat wrote:
Op 23-08-12 21:00, Mason James schreef:
there looks to be some good conversion tools between asciidoc, pod, and wiki
(and then html, docbook, pdf and latex too)
While you're exploring, I hear
I agree with all of you. And must add that a while ago I started the
rewrite of the Ubuntu install files (look at the first commit on that
bug), after which Mark put his hands on it and now we've got this
fresh install instructions.
For that purpose I set (on our infrastructure) both a 10.04 and
On 2012-08-23, at 4:12 PM, Mark Tompsett wrote:
Greetings,
Yes, I was hoping to getting around to cleaning up the documentation further.
However until I have a 64-bit OS to attempt to install, I can't really
address all the problems some people are encountering. Which bugs me, because
On 2012-08-24, at 2:02 AM, Tomas Cohen Arazi wrote:
I agree with all of you. And must add that a while ago I started the
rewrite of the Ubuntu install files (look at the first commit on that
bug), after which Mark put his hands on it and now we've got this
fresh install instructions.
For
On Thu, Aug 23, 2012 at 10:49 AM, Mason James m...@kohaaloha.com wrote:
I already volunteered for Ubuntu files.
awesome Tomaz
i'll volunteer to update and do QA on the debian INSTALL.* files
If we can agree to some sort of standardized formatting, I'll write a
parser to generate the
Op 23-08-12 17:14, Chris Nighswonger schreef:
If we can agree to some sort of standardized formatting, I'll write a
parser to generate the wiki pages from the INSTALL files.
Wiki formatting would make sense, wouldn't it?
It's reasonably readable too.
--
Robin Sheat
Catalyst IT Ltd.
✆ +64 4
Hi,
On 08/23/2012 11:14 AM, Chris Nighswonger wrote:
If we can agree to some sort of standardized formatting, I'll write a
parser to generate the wiki pages from the INSTALL files.
Speaking of standardized formatting, how about AsciiDoc? [1]
Some advantages:
- producing HTML and other
On Thu, Aug 23, 2012 at 11:17 AM, Robin Sheat ro...@catalyst.net.nz wrote:
Op 23-08-12 17:14, Chris Nighswonger schreef:
If we can agree to some sort of standardized formatting, I'll write a
parser to generate the wiki pages from the INSTALL files.
Wiki formatting would make sense,
On 2012-08-24, at 3:25 AM, Chris Nighswonger wrote:
On Thu, Aug 23, 2012 at 11:17 AM, Robin Sheat ro...@catalyst.net.nz wrote:
Op 23-08-12 17:14, Chris Nighswonger schreef:
If we can agree to some sort of standardized formatting, I'll write a
parser to generate the wiki pages from the
Op 23-08-12 21:00, Mason James schreef:
there looks to be some good conversion tools between asciidoc, pod, and wiki
(and then html, docbook, pdf and latex too)
While you're exploring, I hear good things about markdown as a
human-writable but still parseable format, and I'd give good odds
On 2012-08-24, at 7:28 AM, Mark Tompsett wrote:
Greetings,
Right now. People are probably doing “less INSTALL.blah”. Less is standard.
We’ve got a perl application being installed, so perldoc isn’t a far fetched
expectation. As long as we get a format where people can easily “program
Regards
To+
PS: Sorry for my poor english.
PS2: I've struggled and got annoyed for the outdated docs, and even
filled this http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=8478.
You'll see Mark's work there.
Tomas
there has been some discussion about ways to improve the Koha
On 23 August 2012 12:25, Mason James m...@kohaaloha.com wrote:
Regards
To+
PS: Sorry for my poor english.
PS2: I've struggled and got annoyed for the outdated docs, and even
filled this http://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=8478.
You'll see Mark's work there.
Tomas
Salvete!
the big problem is...
there are too many 'Koha installation guides' on the kc.org wiki that
have old ,incorrect, redundant or duplicated info
Alternatively, we could mark those entries up with wiki tags to reflect
that there is old, incorrect, or redundant redundant
On 23 August 2012 13:52, Chris Nighswonger cnighswon...@foundations.edu wrote:
On Wed, Aug 22, 2012 at 9:01 PM, Chris Cormack ch...@bigballofwax.co.nz
wrote:
what do other Koha devs think?
does anyone else agree that these old or inaccurate install guides are
causing problems for Koha
Greetings,
Yes, I was hoping to getting around to cleaning up the documentation
further. However until I have a 64-bit OS to attempt to install, I can't
really address all the problems some people are encountering. Which bugs me,
because I want good documentation for all three types of
27 matches
Mail list logo