Difference between revisions of "Projects/Documentation/KDE4"

Jump to: navigation, search
(System Settings)
m
(11 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
= KDE 4 Documentation Tasks =
 
= KDE 4 Documentation Tasks =
The following task list is broken down by experience as closely as possible. It is recommended that you join #kde-docs on IRC (Freenode) and coordinate with the other members as to not create any problems or duplicate work. Currently the channel is quite slow and quiet.
+
The following task list is broken down by experience as closely as possible. It is recommended that you join [irc://chat.freenode.net/kde-docs #kde-docs] on IRC (Freenode) and coordinate with the other members as to not create any problems or duplicate work. Currently the channel is quite slow and quiet.
  
 
If you choose to work on any of the following documents, please add your name, IRC name, and email address for communication purposes.
 
If you choose to work on any of the following documents, please add your name, IRC name, and email address for communication purposes.
  
If you haven't yet subscribed to the KDE Documentation mailing list, please do so now at https://mail.kde.org/mailman/listinfo/kde-doc-english and say hello. Maybe provide a little bit of information as well as your experience.
+
If you haven't yet subscribed to the KDE Documentation mailing list, please do so now at [https://mail.kde.org/mailman/listinfo/kde-doc-english this page] and say hello. Maybe provide a little bit of information as well as your experience.
  
'''NOTE:''' Please use the [[#EBN|English Breakfast Network]] while working on documentation.
+
{{Note|Please use the [[#EBN|English Breakfast Network]] while working on documentation.}}
  
 
== Beginner ==
 
== Beginner ==
 
=== EBN ===
 
=== EBN ===
EBN, or the [http://www.englishbreakfastnetwork.org English Breakfast Network], is a utility that both developers and documentation writers use to make sure they have created perfection for KDE. For documentation, there is are 2 utilities which will make your work easier:
+
EBN, or the [http://www.englishbreakfastnetwork.org English Breakfast Network], is a utility that both developers and documentation writers use to make sure they have created perfection for KDE. For documentation, there are 2 utilities which will make your work easier:
 
# [http://www.englishbreakfastnetwork.org/sanitizer/?component=kde-4.x Documentation Sanitizer] - this utility within the EBN scours the trunk of the subversion repository checking the format of the documentation, discovering typos, grammar, markup, and more. This is a perfect utility for beginners looking to contribute as this tool pretty much tells you how to fix the issues.
 
# [http://www.englishbreakfastnetwork.org/sanitizer/?component=kde-4.x Documentation Sanitizer] - this utility within the EBN scours the trunk of the subversion repository checking the format of the documentation, discovering typos, grammar, markup, and more. This is a perfect utility for beginners looking to contribute as this tool pretty much tells you how to fix the issues.
 
# [http://www.englishbreakfastnetwork.org/sanitizer/just-in-time.php Just In Time] - this utility allows you to check your code/documentation and it will provide the same information that the sanitizer above produces. Use this before committing your patches or committing to subversion.
 
# [http://www.englishbreakfastnetwork.org/sanitizer/just-in-time.php Just In Time] - this utility allows you to check your code/documentation and it will provide the same information that the sanitizer above produces. Use this before committing your patches or committing to subversion.
  
=== KColorEdit ===
+
=== Documentation Primer ===
* '''Location:''' trunk/extragear/graphics
+
* '''Status:''' Needs updating and new material
+
* '''Info:''' Should be a fairly straight forward process with the updating and new material addition.
+
* '''Document writer:''' ''TimS on IRC, or via the mailing list.''
+
  
=== Gwenview ===
+
Here is a [[Documentation_Primer/Manual|comprehensive manual]] about KDE DocBooks creating.
* '''Location:''' trunk/KDE/kdegraphics
+
* '''Status:''' Needs updating
+
* '''Info:''' Documentation is based on the KDE 3 release, needs to be updated to match the KDE 4 release.
+
* '''Document writer:''' ''Henry de Valence: hdevalence (at) gmail (dot) com''
+
  
== Intermediate ==
+
=== Useful Links on Wikis ===
  
=== Kalzium ===
+
* [[Projects/Documentation/KDE4_(health_table)|Health Table]]. Please do not hesitate to improve it.
* '''Location:''' trunk/KDE/kdeedu
+
* [[Schedules/KDE4/4.11_Release_Schedule|Current release schedule]]
* '''Status:''' Needs updating and new material
+
* [[Schedules/KDE4/4.11_Feature_Plan|Feature plan of the current release]]
* '''Info:''' Many parts of the Kalzium document needs to be updated and there are yet many parts that haven't been documented.
+
* '''Document writer:''' ''Karthik Periagaram (karthikp on IRC, karthikp AT gatech DOT edu)''
+
  
=== Parley ===
+
=== KColorEdit ===
* '''Location:''' trunk/KDE/kdeedu
+
* '''Location:''' [http://websvn.kde.org/trunk/extragear/graphics/doc/kcoloredit/ trunk/extragear/graphics]
 
* '''Status:''' Needs updating and new material
 
* '''Status:''' Needs updating and new material
* '''Info:''' There are quite a bit of KDE 3 and KVocTrain references still in the documentation.
+
* '''Info:''' Should be a fairly straight forward process with the updating and new material addition.
* '''Document writer:''' ''Stephanie Whiting stephaniewhiting on IRC, stephaniewhiting03@gmail.com''
+
* '''Document writer:''' kde-doc-english mailing list, [irc://chat.freenode.net/kde-docs #kde-docs]
  
=== Step ===
+
== Intermediate ==
* '''Location:''' trunk/KDE/kdeedu/doc/step
+
* '''Status:''' Examples need to be documented, a template is started as examples.docbook - Index.docbook can be improved.
+
* '''Info:''' You need to be good in Physics - coordinate with annma
+
* '''Document writer:'''
+
** Object Info: [[User:JLP|Jure Repinc]]
+
  
 
== Advanced ==
 
== Advanced ==
 +
<!--
 
=== kdelibs ===
 
=== kdelibs ===
 
* '''Location:''' trunk/KDE/kdelibs
 
* '''Location:''' trunk/KDE/kdelibs
Line 53: Line 39:
 
* '''Info:''' There is a TODO file located in trunk/KDE/kdelibs/doc/ - refer to this for more information.
 
* '''Info:''' There is a TODO file located in trunk/KDE/kdelibs/doc/ - refer to this for more information.
 
* '''Document writer:''' ''Richard Johnson (nixternal) <nixternal AT kubuntu DOT org>''
 
* '''Document writer:''' ''Richard Johnson (nixternal) <nixternal AT kubuntu DOT org>''
 
+
-->
=== System Settings ===
+
* '''Location:''' usually in subdir doc/kcontrol of a module (kdeadmin, kdebase/workspace, kdebase/runtime, kdegraphics, kdepimlibs, kdeutils, exceptions of that rule are dolphin/kxkb/kscd/kdm and some more)
+
* '''Status:''' ·~85% up to date in 4.4
+
* '''Info:''' Missing / outdated docs:
+
** Service Discovery (kcmshell4 kcm_kdnssd) - missing
+
** Network Setting (kcmshell4 kcm_knetworkconfmodule) - outdated
+
** Size & Orientation (kcmshell4 randr) - outdated
+
** Multiple Monitors (kcmshell4 xinerama) - missing
+
** Input Actions (kcmshell4 khotkeys) - missing
+
** Printer Configuration (kcmshell4 system-config-printer-kde) - missing
+
** Audio CDs (kcmshell4 audiocd) - opens kioslave/audiocd - wrong
+
** Samba (kcmshell4 kcmsambaconf) - missing
+
** Task Scheduler (kcmshell4 kcm_cron) - outdated, is kcron handbook from kde3
+
* '''Document writer:''' ''Richard Johnson (nixternal) <nixternal AT kubuntu DOT org>''
+
  
 
=== KMail ===
 
=== KMail ===
* '''Location:''' trunk/KDE/kdepim
+
* '''Location:''' [http://quickgit.kde.org/?p=kdepim.git&a=tree&f=doc%2Fkmail KDE/kdepim]
 
* '''Status:''' Needs a lot of updating and new material
 
* '''Status:''' Needs a lot of updating and new material
 
* '''Info:''' Check with Allen Winter (winterz) on IRC and [[Projects/Documentation/KDE4/kdepim/kmail]]
 
* '''Info:''' Check with Allen Winter (winterz) on IRC and [[Projects/Documentation/KDE4/kdepim/kmail]]
* '''Document writer:''' Manfred Mislik (tictric) on IRC
+
* '''Document writer:''' kde-doc-english mailing list, [irc://chat.freenode.net/kde-docs #kde-docs]
  
 
=== KOrganizer ===
 
=== KOrganizer ===
* '''Location:''' trunk/KDE/kdepim
+
* '''Location:''' [http://quickgit.kde.org/?p=kdepim.git&a=tree&f=doc%2Fkorganizer KDE/kdepim]
 
* '''Status:''' Needs a lot of updating and new material
 
* '''Status:''' Needs a lot of updating and new material
 
* '''Info:''' Check with Allen Winter (winterz) on IRC
 
* '''Info:''' Check with Allen Winter (winterz) on IRC
* '''Document writer:''' ''Vikram Dhillon <dhillonv10 AT lavabit DOT com>''
+
* '''Document writer:''' kde-doc-english mailing list, [irc://chat.freenode.net/kde-docs #kde-docs]

Revision as of 20:16, 12 June 2013

Contents

KDE 4 Documentation Tasks

The following task list is broken down by experience as closely as possible. It is recommended that you join #kde-docs on IRC (Freenode) and coordinate with the other members as to not create any problems or duplicate work. Currently the channel is quite slow and quiet.

If you choose to work on any of the following documents, please add your name, IRC name, and email address for communication purposes.

If you haven't yet subscribed to the KDE Documentation mailing list, please do so now at this page and say hello. Maybe provide a little bit of information as well as your experience.

noframe
 
Note
Please use the English Breakfast Network while working on documentation.

Beginner

EBN

EBN, or the English Breakfast Network, is a utility that both developers and documentation writers use to make sure they have created perfection for KDE. For documentation, there are 2 utilities which will make your work easier:

  1. Documentation Sanitizer - this utility within the EBN scours the trunk of the subversion repository checking the format of the documentation, discovering typos, grammar, markup, and more. This is a perfect utility for beginners looking to contribute as this tool pretty much tells you how to fix the issues.
  2. Just In Time - this utility allows you to check your code/documentation and it will provide the same information that the sanitizer above produces. Use this before committing your patches or committing to subversion.

Documentation Primer

Here is a comprehensive manual about KDE DocBooks creating.

Useful Links on Wikis

KColorEdit

  • Location: trunk/extragear/graphics
  • Status: Needs updating and new material
  • Info: Should be a fairly straight forward process with the updating and new material addition.
  • Document writer: kde-doc-english mailing list, #kde-docs

Intermediate

Advanced

KMail

KOrganizer

  • Location: KDE/kdepim
  • Status: Needs a lot of updating and new material
  • Info: Check with Allen Winter (winterz) on IRC
  • Document writer: kde-doc-english mailing list, #kde-docs

KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V.Legal