[FM Discuss] using Flossmanuals (was: request to start new manual for Mifos)

[Anne Gentle]

Thanks, Adam... some responses are below.

On Mon, Mar 8, 2010 at 12:04 PM, Adam Monsen <haircut at gmail.com> wrote:

> Anne Gentle wrote:
> > Feel free to mail the list if you get stuck.
>
> We've got a few questions about using the Flossmanuals interface.
>
> But first I wanted to say how cool it is to see who's editing what,
> via http://en.flossmanuals.net/bin/view/Mifos/WebHome and the
> irc.freenode.net#flossmanuals. Great work!
>
> 1. Is it possible to link to other sections of a book? For instance,
> link to the Glossary from somewhere in the Introduction? If yes, is
> this advisable/recommended?
>

You can, by using the URL that is in the published manual (such as
http://en.flossmanuals.net/Audacity/InstallingUbuntu). But you don't have a
published manual yet - which you naturally asked about in the next question.


Generally, we discourage links to other chapters for a couple of reasons:

1. links do not render well in print
2. if a chapter is renamed or deleted you might make the link outdated
3. if the manual is translated, links have to be "translated" too so that
they point to the correct language

These are mostly maintenance issues.



>
> 2. How does publishing (ie: making "live") work? Does one of us
> working on the Mifos manual do the publishing?
>

When you want to publish a draft, send an email to the list and someone with
publish privileges will publish it. Typically this doesn't take long. We can
talk more about adding privileges to a maintainer person if you think that's
the right model for your group - see
http://en.flossmanuals.net/FLOSSManuals/Maintainers.


>
> 3. Is there some kind of review process? i.e.: can we accept or reject
> individual changes?
>

Generally, the work flow is not complex enough to "reject" a change. You
would simply revert to a previous version of the chapter.


>
> 4. I'm editing a long chapter. 1. I insert a screenshot. 2 I position
> the cursor at the end of the shot and press Enter. 3. All the chapter
> below that screenshot disappears. what is the recommended way to
> create a new line underneath a screenshot?
>
>
This may be a bug. Perhaps switch to source view and see if it still
happens?


> 5. How does one adjust font size inside tables?
>

Hm. As far as I know, you'd have to use the source view and use font size
markup, which is probably not a good idea since I'm not sure how it would
look in the resulting HTML and PDF, so your hand markup might get clobbered
anyway upon output. Is it too small or too big? Maybe someone else on the
list would have ideas for you.

Hope this helps -
Anne


>
> Thank you!
> -Adam
> _______________________________________________
> Discuss mailing list
> Discuss at lists.flossmanuals.net
> http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.flossmanuals.net/pipermail/discuss-flossmanuals.net/attachments/20100308/cd71c81e/attachment.htm>