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
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. Standa
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
INSTAL
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
and guide. Standards are good.
+1 for the
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 dele
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-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 i
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
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 l
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 ;-)
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
con
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 explo
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 good things about markdown as a
> human-writab
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 “
> ”
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 “
” after a “sudo apt-get install ”, I don’t care.
Particularly if
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
the
On 2012-08-24, at 3:25 AM, Chris Nighswonger wrote:
> On Thu, Aug 23, 2012 at 11:17 AM, Robin Sheat 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.
>
On Thu, Aug 23, 2012 at 11:17 AM, Robin Sheat 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, wouldn't it?
>
>
I
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 output
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
On Thu, Aug 23, 2012 at 10:49 AM, Mason James 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 wiki pages f
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.
>
>
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, becaus
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 1
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 install
On 23 August 2012 13:52, Chris Nighswonger wrote:
> On Wed, Aug 22, 2012 at 9:01 PM, Chris Cormack
> wrote:
>>
>> > what do other Koha devs think?
>> > does anyone else agree that these old or inaccurate install guides are
>> > causing problems for Koha newbies?
>> >
>> +1 for bringing them into
On Wed, Aug 22, 2012 at 9:01 PM, Chris Cormack wrote:
> > what do other Koha devs think?
> > does anyone else agree that these old or inaccurate install guides are
> causing problems for Koha newbies?
> >
> +1 for bringing them into version control and under signoff/qa process.
>
>
If we follow th
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 12:25, Mason James 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
>
> 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 th
31 matches
Mail list logo
