This Spec is a WORK IN PROGRESS

The Adept User Guide is a reference to the Adept Package Manager, the new package management application included with Kubuntu 5.10; it has not yet been officially released. This guide will provide high-level introductions to concepts and instruction on how to accomplish the most common tasks. The guide will be released at version 1.0 and will coincide with Kubuntu 6.04 release in April 2006. TableOfContents

Document Plan for the Kubuntu Adept Guide

1. Audience: The audience for the Adept User Guide is the first-time/new Kubuntu/KDE user. This user will not be new to computing, in general, and will have a good idea of the tasks he/she wants to perform, but may be left searching when it comes to relating past experience to Kubuntu.

2. Document Outline: See the Document Outline section below. The freeze date for the outline has not been met.

3. Target Presentation Formats: HTML

4. License: GFDL and CC-BY-SA (for details, see DocteamLicense)

5. Technologies and Techniques: The Adept User Guide will be written in DocBook XML, and stored in the docteam's Subversion repository. Previews of this document will be available from the [:DocteamProjects:Docteam Projects Page] and every attempt will be made to ensure that this preview is up-to-date, however, the Subversion repository will always store the latest version.

6. Release Target: The guide will be released at version 1.0 to coincide with the 6.04 Kubuntu release; following the Dapper Drake release schedule (LINK PAGE HERE).

7. Links to Current Version: At this time, the most current version is only available in the docteam's Subversion repository (see below for instructions on how to retrieve it).

8. How to Contribute: There are two ways to participate: 1) send an email to the ubuntu-doc mailing list (ubuntu-doc@lists.ubuntu.com), or 2) make changes directly to the svn repository (see DocteamStepByStepRepository).

9. Primary Contact: [:TroyWilliams:Troy Williams] ("judax" on irc channel #ubuntu-doc at irc.freenode.net). I also read the ubuntu-doc mailing list.

Current Version

For now, the best way to get the entire Kubuntu Adept Guide is to check the files out of the docteam's svn repository. For help on how to get the files, see DocteamStepByStepRepository.

You can also use the links at the bottom of this page to view the various sections of the guide (CONTENT DOES NOT EXIST AT THIS TIME). Eventually, the Adept User Guide wiki pages will be synchronized with the svn repository.

To build an HTML version of the Adept User Guide, change to the kde directory and at the command line type make ???.

Note: Result of the above make can be found in ../ubuntu-docs/build/kde/adeptguide/.

Example:

troy@ubuntu:~ $ 
troy@ubuntu:~ $ cd ubuntu-doc/kde
troy@ubuntu:~/ubuntu-doc/kde$ make ???

To see the Kubuntu Adept Guide in GNOME's help browser, change to the adeptguide directory and at the command line type yelp adeptguide.xml &.

Example:

troy@ubuntu:~/ubuntu-doc/kde/adeptguide/C $ yelp adeptguide.xml &

Feel Free to Contribute

All comments, suggestions, and criticisms are welcome.

IMPORTANT: The Adept User Guide will be released under the GFDL and CC-BY-SA licenses. If you are going to add content which is copied verbatim from another source, you MUST make sure that it is allowed, and you must include a reference to the source.

Also, list your name with anything you contribute so we can add it to the Acknowledgements section of the Adept User Guide. Major contributors will be added as co-authors.

The Adept User Guide source is contained in one file. The file is adeptguide.xml.

Document Outline

1. Add content here
2. Add content here
3. Add content here
4. Add content here
5. Add content here

CategoryDocteam