In Need of a Tutorial
Rich Johnson
nixternal at ubuntu.com
Sun Dec 24 21:18:09 UTC 2006
On Sunday 24 December 2006 14:37, t u wrote:
[snip]
|
| by the way, is there a way to use canonical's bzr instead of svn?
We have looked at it, and at this point in the Bazaar development, it is still
lagging behind a little bit. What the future brings we don't know, but using
SVN has worked for us since the beginning so it will stay for the time being.
We do have a Bazaar branch somewhere (look through the past 2 months archives
on this list, Jonathan Riddell created the branch).
| thanks a lot for the reply & help :)
As for some information and tutorials for documenting. There are a ton. I do
mainly Kubuntu documentation, so we tend to follow the KDE Style Guide with a
combination of the Ubuntu Style Guide. Also, when I am working, I tend to
keep a browser open with the Official DocBook book (that one is silly to say
really fast) open. Here are just a couple of the links I tend to follow:
DocBook: The Definitive Guide
http://docbook.org/tdg/en/html/docbook.html
The DocBook Wiki
http://wiki.docbook.org/topic/
The Linux Documentation Project Guide (good bit of info)
http://www.tldp.org/LDP/LDP-Author-Guide/html/index.html
DocBook XSL: The Complete Guide (this is to DocBook as CSS is to HTML)
http://www.sagehill.net/docbookxsl/
Version Control with Subversion (Excellent info for proper SVN use)
http://svnbook.red-bean.com/nightly/en/svn-book.html
-----------------------------------------------------------
IF YOU ARE INTO DOCUMENTING KDE/KUBUNTU THE FOLLOWING ARE GOOD AS WELL
KDE Documentation Primer | KDE DocBook Authors Guide | KDE Style Guide
http://l10n.kde.org/docs/
-----------------------------------------------------------
Hope some of this helps.
--
Rich Johnson
nixternal at ubuntu.com
GPG Key: 0x2E2C0124
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: not available
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20061224/63a6267f/attachment.pgp>
More information about the ubuntu-doc
mailing list