Bug 233220

Summary: Docs need serious revamping
Product: [Applications] k3b Reporter: Jonathan Thomas <echidnaman>
Component: generalAssignee: Michał Małek <michalm>
Status: RESOLVED FIXED    
Severity: normal CC: aacid, kde-doc-english, lueck, simonandric5, trueg, yurchor
Priority: NOR    
Version: 1.91.0   
Target Milestone: 2.1   
Platform: unspecified   
OS: All   
Latest Commit: Version Fixed In:

Description Jonathan Thomas 2010-04-04 03:53:11 UTC 
Version:           1.91.0 (using 4.4.2 (KDE 4.4.2), Kubuntu packages)
Compiler:          cc
OS:                Linux (i686) release 2.6.32-19-generic-pae

As it stands in K3b 1.91.0, the docs shipped with K3b haven't been touched since K3b 1.x days. The screenshots are all for KDE3, and there's even an entire section on the DCOP interface. There's also grammatically ...unique... passages such as:

" In this dialog is nothing you can do. Just wait for you computer to finish the session."

At this point, I think that it'd be better to just skip the documentation for 2.0, as the current documentation contains a lot of useless, outdated information, outdated screenshots, and generally gives off an unprofessional vibe.
Comment 1 markuss 2010-05-22 00:15:00 UTC 
A student offered to revamp the documentation. Since we're in string freeze since some time, we can't change it for 2.0.
However, it's likely that we'll just link to KDE UserBase in the future and delete the DocBook-based documentation altogether.
Comment 2 Albert Astals Cid 2014-09-29 22:19:33 UTC 
Doc people maybe you can help here?
Comment 3 Yuri Chornoivan 2014-09-30 04:37:11 UTC 
Docs were updated back in 2011 (K3b 2.0), screenshots were updated too.

https://docs.kde.org/stable/en/extragear-multimedia/k3b/index.html