[tbb-dev] Current thoughts on tb-manual presentation

[Lunar]

Matt Pagan:
> > PDF are great when you print. For online uses, really, nope (unless you
> > want the feeling of a book — but we are not doing a book).
> 
> I got the impression I was working on something book-like. I'm familiar
> with other user manuals being either books or pdf documents.

In my mind, we are creating an online help manual. Look at what happen
when you open Firefox (or Tor Browser for the time being) Preferences
and click on the Help button. Look also what the index look like when
you go to Help in the Help menu.

The various screens of the wizard and the Network Preferences panel
should have similar Help button. We need to have an index as well,
but it's easy to combine both approaches with Mallard.

What we care about that needs to be read out of the Tor Browser:

 * How to circumvent censorship
 * Troubleshooting when Tor Browser does not start
 * How to get more support

Have I missed anything? In any cases, it's a small subset of the manual.

But sure, you can read an online help manual cover-to-cover. It's
actually what I did with every house appliances since I was a kid. But I
don't believe most people do that.

-- 
Lunar                                             <lunar at torproject.org>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 836 bytes
Desc: Digital signature
URL: <http://lists.torproject.org/pipermail/tbb-dev/attachments/20140529/9cb2b45f/attachment.sig>