Tutorial guidelines

From FreeCAD Documentation
Revision as of 21:09, 19 October 2014 by Renatorivo (talk | contribs) (+ Category:Wiki)
Note

This is meant as a test for a new style guideline for tutorials.Feel free to add any ideas or test formatting. DO NOT TRANSLATE!

Inspirations & ideas: Comments from yorik and normandc:



Tutorial
Topic
{{{Topic}}}
Level
What level of user is it meant for?
Time to complete
How long does it take to complete?
Authors
Add a link to your forum profile
FreeCAD version
What FreeCAD version are you using?
Example files
None
See also
None

Introduction

Hello readers, the following document is meant as both a proof of concept and as a test platform to try new ideas; this in order to set a new standard in the creation of tutorials. Hopefully you will find it useful whether as a real guideline or as reference material. And so, without further ado allow me to describe each section of the document. What you are reading right now is meant to be used as a brief summary for your work, perhaps mentioning what modules you will use and screenshot of the finished project to use as a thumbnail (hopefully someone will figure how to do it). The box to the right is a new template for tutorials in which concise information can be obtained, such as author, FreeCAD version, and the intended user level.

Thumbnail for the project.
Learning


Tutorial Guidelines: Links and descriptions within the template Rightbox should be meant as a tool to reference other wiki pages that may aid in the comprehension of the tutorial. Such as a link to the Part Module.

Video tutorials: Discover the extensive collections of FreeCAD videos made by community members

Welcome!

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Welcome!

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Welcome!

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Learning


Avoid abusing boxes, however. Perhaps one per two sections of the tutorial might be enough. Note that you can include images wihtin the boxes as well.

Thumbnail for the project.

Welcome!

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Welcome!

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Welcome!

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Note

Remember that it is possible to use boxes to occupy the entire width of the page. This can be useful to highlight something or to create a gallery. Below are two styles to present a gallery.

Thumbnail for the project.
Thumbnail for the project.