Projects/Documentation/KDE: Difference between revisions

From KDE TechBase
No edit summary
(Adding apps needing doco work)
Line 1: Line 1:
This page is still a work in progress.
= KDE 4 Documentation Tasks =
{| class="wikitable" border="1"
|+ Task list (breakdown into task levels when ready)
|-
! Application
! Status
! Info
|-
| KGet
| Update
| KDE 3 -> KDE 4
|-
| Dolphin
| Update
| No update since 2006
|-
| Kalzium
| Update and add new
| Has old parts and non-documented parts
|}


= KDE 4 Documentation =
== Beginner ==
KDE 4 is the next major milestone and release for the KDE project. With this new release, due out towards the end of 2007, comes a great amount of additions, changes, and fixes in order to provide users with the tools needed in order to maintain their KDE system.
To be determined.


== Background and Requirements ==
== Intermediate ==
With the amount of work required in order to get KDE 4 documentation where it needs to be, there are tasks available for all sorts of skill sets. Whether you are the seasoned technical writer familiar with DocBook and XML or you are someone who just started using KDE and/or Linux, there is a task waiting for you. There are requirements in order to contribute to the base documentation. These requirements are the ability to read and write clearly in English. That's it!
To be determined.


== Task List ==
== Advanced ==
The available tasks start from typical spelling and grammar checking, all the way up to creating and maintaining documentation for new applications. This document will try to provide available tasks oriented towards the various levels of experience and this document will continue to expand in order to cover every possible task to reach our goal.
To be determined.
 
=== Beginner ===
The Beginner level will encompass the very basic tasks required in order to assist the KDE Documentation Project. These tasks will normally include spelling and grammar checking/fixing, readability, and if possible technical correctness. Spelling and Grammar checking/fixing is rather straight forward. Readability will require you to read through a document and report back if there are portions that are unclear or confusing. Technical correctness requires a little knowledge with KDE 4 and/or the application documentation you are reviewing. If you are unfamiliar with the technology being covered in the documentation, then it may be easier for you to adopt a task or document in which are more familiar with.
 
To see a list of Beginner level tasks, please review <INSERT PAGE NAME & LINK>
 
=== Intermediate ===
The Intermediate level will encompass tasks that are a bit more involved than the Beginner level tasks. Of course you will still utilize the requirements and jobs listed above in the Beginner level tasks. The Intermediate level tasks will require you to be a little more familiar with SVN (anonymous unless you have an account) as well as DocBook and XML. A great tool for the Intermediate level to utilize, as well as the Beginner level, is the [http://www.englishbreakfastnetwork.org/ English Breakfast Network] or EBN[1] for short.
 
To see a list of Intermediate level tasks, please review <INSERT PAGE NAME & LINK>
 
=== Advanced ===
The Advanced level will encompass tasks such as creating a document from scratch utilizing the DocBook/XML DTD and have full understanding of the KDE Style Guide as well as the community itself. Contributors that fall under the advanced level will also help those contributing at both the Beginner and Intermediate levels. A contributor in this level should be able to answer a majority of the questions asked by the previous 2 levels or should be able to locate an answer easily within the community.
 
To see a list of Advanced level tasks, please review <INSERT PAGE NAME & LINK>

Revision as of 17:46, 21 March 2008

KDE 4 Documentation Tasks

Task list (breakdown into task levels when ready)
Application Status Info
KGet Update KDE 3 -> KDE 4
Dolphin Update No update since 2006
Kalzium Update and add new Has old parts and non-documented parts

Beginner

To be determined.

Intermediate

To be determined.

Advanced

To be determined.