Rockbox.org home
release
dev builds
extras
themes manual
wiki
device status forums
mailing lists
IRC bugs
patches
dev guide



Rockbox mail archive

Subject: Re: r24917: again no manual update

Re: r24917: again no manual update

From: Jonathan Gordon <jdgordy_at_gmail.com>
Date: Fri, 26 Feb 2010 00:14:04 -0800

On 26 February 2010 00:05, Björn Stenberg <bjorn_at_haxx.se> wrote:
> Jonathan Gordon wrote:
>> WPS tags should NOT be in the manual.
>> 1) its too bloodu long which scares people away from reading it (yes
>> its in an appendix but still, seeing 100+ pages is enough to turn
>> people off)
>
> We already have 10 pages of WPS tags in the manual. Unless we decide to completely remove all WPS tags from the manuals, all tags should be there.
>
> Having 75% of tags in the manual and the rest on a wiki page (which isn't even mentioned in the manual) is a lousy solution.
>
> I also disagree that having a short manual is a goal in itself. I'd much rather have a 400 page complete manual than a 40 page "best of" manual.
>
> --
> Björn
>

Most people are lazy, especially when it comes to reading (as proven
by the support requirements in the forums and IRC). While I obviously
cant say that making the manual short would fix that, it is a likely
possibility.
Anyway, I'm not suggesting activly removing parts that actually belong
there, but things like the settings listing, the wps listing, the GPL
license, credits, etc are all badl placed.

The manual should be the place to easily find out how to use rockbox,
specifically, how to navigate the settings and some of the finer
points. If someone wants to dive deeper into the settings or themeing
then they should go to an area of the site especially for them,
otherwise its information overload for those who just want to figure
out how to play music.
Received on 2010-02-26


Page was last modified "Jan 10 2012" The Rockbox Crew
aaa