Blender Documentation: Last modified May 20 2003 S68 | ||
---|---|---|
<<< Previous | About the Blender Documentation Project | Next >>> |
To maintain consistency throughout all Blender Documentation, perspective authors are kindly requested to abide to the present Style Guide.
Blender documentation should be written in clear, concise, idiomatic and correct English. It should be adequately subdivided into chapter, sections and subsections.
The logical subdivision of Core documentation is dictated by the Documentation Board.
The logical subdivision of contributed Tutorials is left to each author, but it is strongly adviced that the authors provide a list of up to five keywords from the the Section called Keywords to classify their work. Please type Keywords exactly since they will be indexed for searches.
Tutorials should contain an abstract of up to 300 words briefly describing topic, aims and contents for quick browsing.
The utilization of images in the documentation is essential. The PNG and JPG formats are highly preferred. GIF and other non-free formats are prohibited. Uncompressed formats like TGA are discouraged.
Float images should bear a caption and be referenced in the text. Please refrain from wording like the next picture or the following figure. Use cross references. Cross references are described the Section called Cross references
The usage of unreferenced images is discouraged. If you have an image you don't know how to reference either the image is unnecessary or your text is unclear.
The Documentation, both Core and Tutorials, is to be published both on the web and as printable matter. Dimension/resolutions should be, at maximum, as reported in Table 1 (see.. crossreferences!)
Table 1. Image resolution/dimensions
Width [pixels] | Height [pixels] | Resolution [dpi] |
---|---|---|
1000 | 768 | 150 |
800 | 600 | 125 |
640 | 512 | 100 |
These resolutions/size guarantees that printed images won't be larger than 17cm and hence fills in a A4 printed page.
The usage of images larger than 800 pixel is anyway strongly discouraged since they are too wide for a confortable reading on a web browser.
Among Blender's Interface most prominent feature is that it's fully OpenGL and scalable. This is great but will sadly result in much disuniformities if many different users resort to screen dumps to show peculiar material settings, texture settings and the like.
To allow for both clarity and uniformity you should dimension the interface so that the RED slider in the material window is 18 pixel hight. This is what Blender produces if you use a 1024x768 screen resolution and press the 'home' button to set the default button size.
If you use a larger resolution, please drop down to 1024x768 for screen capturing. I hope noone out there has smaller screens!
Screen captures must come in a LOSSLESS format, so use PNG.
<<< Previous | Home | Next >>> |
Learning DocBook/XML | Up | Documentation Style in Practice |