[Ronja] Making the instructions easier

[Karel Kulhavy]

On Wed, Nov 29, 2006 at 11:04:38PM +0100, Jakub Sykora wrote:
> What about replacing Models with Ronja Models? Ordinary reader asks 
> Models of what? What models? Adding an hyphen with model names is a good 
> idea indeed.
> 
> If you would like to confuse readers at maximum, you can use Ronja 
> Models' Modules or maybe better Ronja Models'n'Modules and mix the 
> contents together. But I think this is hell highway...

That reminds me that I heard somethere Highway To Hell that had exactly
the right level of rock for me - now I checked, AC/DC is too pussie and
Marilyn Manson is too hard - any idea who could have been that?

And btw happy new year!

CL<
> 
> K
> 
> Karel Kulhavy wrote:
> > On Tue, Nov 28, 2006 at 10:30:42PM +0100, J.D. Bakker wrote:
> >>> Do you have an idea how the Ronja instructions could be made easier?
> >> Two related points:
> >>
> >> - The structuring of the instructions makes it very inconvenient to 
> >> find specific things. Not every user will find it convenient to 
> >> follow the path you force them to take. For example, I have often 
> >> looked for particular parts of the instructions, such as the BOM for 
> >> the twister2, and found it very frustrating to have to hunt through 
> >> different sections. If you must retain the current structure, I would 
> >> suggest you make the 'Contents' pages (like 
> >> http://ronja.twibright.com/tetrapolis/) more verbose [I see you have 
> >> done some restructuring since I last looked, but I would still 
> >> suggest adding more info to the 'Contents'-page]
> > 
> > I don't have to retain the current structure. It could be changed but it
> > would probably take a lot of time, depending on how systemic change it would
> > be.
> > 
> > Now I got an idea about the "Models" and "Modules" on the title page.  If you
> > see "models" and "modules", you have to max out your brain to grab these
> > abstract concepts, figure out the subtle difference between those two almost
> > identical words, and figure out if these abstract concepts encompass the real
> > thing (Twister) you are looking for.
> > 
> > What about replacing Models with "Models - Tetrapolis, Inferno, ... where
> > Tetrapolis, Inferno and ... would be links
> > and Modules with Modules - Twister2, RX, TX, infra RX, ...
> > 
> > and do the same with the contents pages like
> > http://ronja.twibright.com/tetrapolis/ ?
> > 
> > Any suggestion what more could be added to those http://ronja.twibright.com/tetrapolis/ -style
> > content pages?
> > 
> >> - Similarly, you may want to add basic navigation buttons on the top 
> >> and bottom of all build pages. A page like 
> >> http://ronja.twibright.com/twister2/tools.php might include links 
> >> such as 'Back - to materials', 'Forward - to PCB manufacture' and 'Up 
> >> - to (Building the) Ronja Twister2'.
> > 
> > Such navigation is a bit confusing for me personally. You have multiple routes
> > to the same destination. Does it have any more benefits than that it spares
> > one hit of a back button?
> > 
> > CL<
> >> JDB.
> >> -- 
> >> LART. 250 MIPS under one Watt. Free hardware design files.
> >> http://www.lartmaker.nl/
> >>
> >> -- 
> >> Twibright Ronja mailing list http://ronja.twibright.com
> >> Ronja at lists.pointless.net
> >> http://pointless.net/mailman/listinfo/ronja
> > 
> 
> -- 
> Jakub Sýkora
> email: kubajz at kbx.cz       <')
> ICQ: 68976632               ( =-
> mobil: +420 777 594 201      ''
> 
> -- 
> Twibright Ronja mailing list http://ronja.twibright.com
> Ronja at lists.pointless.net
> http://pointless.net/mailman/listinfo/ronja