Difference between revisions of "KDE Documentation/Meetings/Akademy 2010 BoF"

Line 14: Line 14:
  
 
[http://markmail.org/thread/jsaout5up2ft4elq Thread on kde-doc-english with lots of good input]
 
[http://markmail.org/thread/jsaout5up2ft4elq 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

Revision as of 10:03, 7 July 2010

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


This page was last edited on 7 July 2010, at 10:03. Content is available under Creative Commons License SA 4.0 unless otherwise noted.