[FM Discuss] ChucK Manual

[adam hyde]

i tried a few things. will try some stuff tomorrow...looks like u have a
lot of good content :)

adam


On Wed, 2009-12-16 at 13:55 -0700, Adam Tindale wrote:
> Hi All,
> 
> I am the Maintainer for the ChucK documentation and we are in the
> midst of a sprint to get the manual into FLOSS manuals. I have put a
> bunch of it live so you can see it here:
> 
> http://en.flossmanuals.net/ChucK/Introduction
> 
> Our manual is about 190 pages and most of it is now living in FLOSS
> manuals. We also have a few people doing entirely new sections of
> documentation. This is a bit of an experiment to see if a migration is
> actually the best thing for the project.
> 
> I have noticed a bunch of things that I am wondering about.
> 
> 1. There doesn't seem to be a way to delete chapters.
> 2. We have a problem with page 2 (see our places page)
>    It has a repeated <-Previous link at the top and it is messing up
> the formatting.
> 3. OBJAVI outputs one blank page
> 4. The PDF output has many errors. Whenever a word starts with f the
> character gets rendered as something else.
> 
> My short term needs are access to the CSS so I can change the style.
> Because ChucK is a  command line programming language we have greater
> needs for precise formatting so we don't confuse the users.
> 
> I am also hoping to find out about how to control the output of the
> PDF more precisely. Our old manual was made in LaTeX and I have a lot
> of experience there that could be useful.
> 
> I have been doing the manual mostly alone for nearly 5 years. During
> the sprint I had 4 very active users helping out. FLOSS manuals has
> made that possible. In order to convince the project that a full
> migration to FLOSS is the best option I think we will need to be able
> to work out our formatting issues. Any help or advice is greatly
> appreciated.
> 
> Adam
> _______________________________________________
> Discuss mailing list
> Discuss at lists.flossmanuals.net
> http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net


-- 
Adam Hyde
Founder FLOSS Manuals
German mobile : + 49 177 4935122
Email : adam at flossmanuals.net
irc: irc.freenode.net #flossmanuals

"Free manuals for free software"
http://www.flossmanuals.net/about