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