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: Rockbox manual
From: Mike Holden (rockbox_at_mikeholden.uklinux.net)
Date: 2003-04-10


JOSE MARIA GARCIA VALDECASAS BERNAL said:
> Hi all!
>
> A few days later, but i've nearly finished Rockbox manual. I only have
> to change 3 snapshots (While recording screen, Recording F2 and
> Recording F3) This manual is available at:
> http://usuarios.lycos.es/delecami/Rockbox-manual.pdf
>
> Please, if you find any errata, or something i've forgotten, write a
> mail to the list or just to me (as you wish).
>
> I'd like to thank Björn, Daniel, Philipp for their help and Alexandre
> for his first manual (i've copied some things).
>
> I hope you like the manual.
>
> Jose Maria.

It looks good so far Jose. I will read it in more detail at the weekend,
but a couple of initial comments:

I think the paragraphs would look better if the initial line was
left-justified rather than indented. The reason for this is that most
paragraphs are quite short, and often interspersed with other text which
is indented and/or bulletted. This makes it less easy to follow the text.
Maybe a small blank line between paragraphs instead? (just MHO)

Do we need a paragraph somewhere near the top describing the various
models? In particular, I feel we should have a statement that says that
referemces to "recorder" apply equally to "FM recorder" unless otherwise
specified. There are some differences between the FM recorder and the
other recorder models (battery charging and disk poweroff for example),
but most of the operation is the same.

In the ROLO section, we should say that the archos firmware must be
downloaded from the archos web site before users will be able to ROLO it.

Should we also include a copy of the FAQ, since we already include the
NODO list?

-- 
Mike Holden



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