[Bf-committers] Blender doc intergration proposal

[Alexander Ewering]

On Mon, 10 Apr 2006, Mats Holmberg wrote:

> about. Tooltips are usually made useless, take a look at any OS. In blender 
> there are same kind of symptoms - in the 'render' button example, having a 
> tooltip like 'start the rendering' is the same as having no tooltip at all.

Heh. I am reminded of the beginning times of Blender open-source, where some
"newbie-friendlyness" dudes started adding tooltips like "Click to change".
:-) That's still my absolute favourite. I think they're still all over the
UI.

> What the user really wants to know is what 'render' means and whether he/she 
> should press the renderbutton (ie what will happen). For that info to come 
> across there should be a tooltip explaining the result of what happens when 
> the program renders - not that it starts rendering (which is obvious for each 
> and every one). But as an addition to this the possibility to learn about

Sorry, but I think that a tooltip is really the wrong place for a tutorial.
And to be even more honest, I don't think that it's blender's task at all to
teach people basic stuff about 3D technology - they're better off buying a
book at their favourite book store.

Blender documentation should be about blender-specific characteristics and
features, not about 3D in general. If I buy a car, the manual is not about
traffic signs, either.

| alexander ewering              instinctive mediaworks
| ae[@]instinctive[.]de   http://www[.]instinctive[.]de