Hi,
I've offered to help write the revisor documentation, and got this message in reply. Wondered if any body had any suggestions what the best method to do this would be?
Cheers,
Jon
---------- Forwarded message ---------- From: Jonathan Roberts jonathan.roberts.uk@googlemail.com Date: 01-Jun-2007 13:15 Subject: Re: [Revisor-devel] Documentation To: Revisor Development Discussion List revisor-devel@fedoraunity.org
Hey,
I suppose there's a few ways we can do this... We would want the documentation to be available on the Revisor website as well as in the Revisor RPM package, and if it's possible to get them on docs.fp.org we'll be able to just pull the sources from there enabling collaborative editing (right?) and translation (both are huge advantages I think!).
OK, well I'm no expert on this, but I think the two best options for collaborative work are the Fedora Wiki or docbook in the Fedora CVS...how ever we write it though, I guess we can always port it to different formats if necessary after it's written?
I'll forward this message on to the Fedora docs list and someone there will be able to advise us on the best way to achieve this :D
Jon
On Fri, 2007-06-01 at 13:17 +0100, Jonathan Roberts wrote:
I've offered to help write the revisor documentation, and got this message in reply. Wondered if any body had any suggestions what the best method to do this would be?
If you need portability and translatability, you want to do this as DocBook in CVS. It's very easy to get started; for instance, you could read this:
http://cvs.fedoraproject.org/viewcvs/example-tutorial/en_US/example-tutorial...
Alternately, you can get DocBook: the Definitive Guide online as well at http://docbook.org/ although you have to cope with version mismatch, since they don't publish every version there.
We're always around on #fedora-docs to help.
Paul W. Frields wrote:
If you need portability and translatability, you want to do this as DocBook in CVS. It's very easy to get started; for instance, you could read this:
http://cvs.fedoraproject.org/viewcvs/example-tutorial/en_US/example-tutorial...
Alternately, you can get DocBook: the Definitive Guide online as well at http://docbook.org/ although you have to cope with version mismatch, since they don't publish every version there.
We're always around on #fedora-docs to help.
We were thinking about the possibility of getting the docs from CVS and have them in the RPM package; is it possible to just like run a script, get the latest DocBookXML and have it output (selected) .html files?
-kanarip
On Sat, 2007-06-02 at 02:19 +0200, Jeroen van Meeuwen wrote:
Paul W. Frields wrote:
If you need portability and translatability, you want to do this as DocBook in CVS. It's very easy to get started; for instance, you could read this:
http://cvs.fedoraproject.org/viewcvs/example-tutorial/en_US/example-tutorial...
Alternately, you can get DocBook: the Definitive Guide online as well at http://docbook.org/ although you have to cope with version mismatch, since they don't publish every version there.
We're always around on #fedora-docs to help.
We were thinking about the possibility of getting the docs from CVS and have them in the RPM package; is it possible to just like run a script, get the latest DocBookXML and have it output (selected) .html files?
Absolutely. All part of our prefab build toolset.
How about we get content started on the wiki and then move it to CVS for translation and packaging?
See also the discussion on the Fedora Marketing mailing list starting with
http://www.redhat.com/archives/fedora-marketing-list/2007-June/msg00001.html
through
http://www.redhat.com/archives/fedora-marketing-list/2007-June/msg00014.html
and beyond (I am sure).
John Babich Volunteer, Fedora Docs Project
Sounds good to me, I'll happily help out - just as soon as I get sound working on my F7 install! (Lol, on a sidenote, if anybody knows anything about why my Intel HD audio isn't working on my laptop drop me a note off list!!!)
Cheers,
Jon
On 02/06/07, John Babich jmbabich@gmail.com wrote:
How about we get content started on the wiki and then move it to CVS for translation and packaging?
See also the discussion on the Fedora Marketing mailing list starting with
http://www.redhat.com/archives/fedora-marketing-list/2007-June/msg00001.html
through
http://www.redhat.com/archives/fedora-marketing-list/2007-June/msg00014.html
and beyond (I am sure).
John Babich Volunteer, Fedora Docs Project
-- fedora-docs-list mailing list fedora-docs-list@redhat.com To unsubscribe: https://www.redhat.com/mailman/listinfo/fedora-docs-list
On 02/06/07, Jonathan Roberts jonathan.roberts.uk@googlemail.com wrote:
Sounds good to me, I'll happily help out - just as soon as I get sound working on my F7 install! (Lol, on a sidenote, if anybody knows anything about why my Intel HD audio isn't working on my laptop drop me a note off list!!!)
FIxed :D I'll create a wiki page now unless anyone has any other thoughts?
Jon
Jonathan Roberts wrote:
Sounds good to me, I'll happily help out - just as soon as I get sound working on my F7 install! (Lol, on a sidenote, if anybody knows anything about why my Intel HD audio isn't working on my laptop drop me a note off list!!!)
ICH7? See fedora-test list for a workaround.
Rahul
docs@lists.stg.fedoraproject.org
-
Jeroen van Meeuwen -
John Babich -
Jonathan Roberts -
Paul W. Frields -
Rahul Sundaram