KDE Documentation/Meetings/Akademy 2010 BoF

Akademy 2010 BoF

See BoF schedule for date and time.

Agenda

• Status of documentation (content, tools, community, ...)
• Role of Wikis and forum in KDE documentation
• Status of KHelpcenter
• Brainstorming about future of KDE documentation
• Planning for KDE documentation sprint

Input

Thread on kde-doc-english with lots of good input

BoF Notes

(notes by Frederik, please extend)

Doc english as mailing list: not the perfect list name

quality of documentation

• list on techbase
• quality of documentation

what's this help, tooltips

• tooltips too large: on small screen it covers too much

userbase documentation

• parley manual as guinea pig
• page size, images, links, semantics
• versioning of manuals
• file uploading
• translation of screenshots

why not wiki to html/pdf directly

specify what should be in manuals (eg not "how to compile")

formats: gnome

offline docs

Annew:

• people needed to do the incredibly boring stuff regularily - eg fix tamplates

blog on planetkde about userbase manual writing

classroom