Get PAID to write Documentation for Blender - Blender Summer of Documentation

The Blender Summer of Documentation results have been decided, with ten participants selected to spend a month over summer writing high-quality user documentation. Proposals were selected from a field of 25 entrants, all of exceptionally high standard, and cover an impressive range of Blender Basics.

The proposals accepted:

Stephen Swaney(stivs) - Introduction to Python Scripting

Stephen’s contribution to Blender’s Python scripting interface puts him in a great position to provide this introduction to Python. Covering a huge amount of territory, he proposes to lead the reader from the very beginning of learning Python, through a series of progressively more difficult and interesting scenarios useful for the average Blender user. Covering the basics such as introductory Python, the Blender text editor, Scriptlinks and object creation, and leading into applications such as animation, material creation, importers and exporters, this project will bridge a gap many Blender users find difficult to cross.

Mal - Introduction to the Game Engine

Mal’s knowledge of the game engine is undisputed as a past employee of NaN working on interactive content. In this project he proposes to lead the reader through the complete process of turning an empty scene into a game, teaching things such as level creation, GE materials, logic bricks and user interaction. Utilising the latest Blender Game Engine updates, specifically the Bullet physics engine, further updates and additions will be possible with future developments.

Ryan Dale - Introduction to Character Animation

The tutorial that will replace Gus! Ryan’s project will cover just about every character animation subject. Introducing the topic with a basic overview of modeling, and texturing a character, Ryan will lead onto the more advanced topics of rigging and character animation, including detailed overviews of posing, actions and the NLA. Furthermore, this project will, along with the next, provide the future entrance point for learning character animation with Blender.

Robert christian(wavez) - Introduction to Rigging

Rob’s Introduction to Rigging will provide readers with an incredible reference resource. This project will cover the basics of rigging before leading into the complex rigging of legs/feet and spines, explaining both the theory and implementation of these tricky areas. Furthermore, the coverage of envelopes and weight painting will complete the picture, leaving the user with a series complete, animatable rigs for different uses.

Felipe Bergamin Boralli - Introduction to Physical Simulation

As a mechanical and aeronautical engineering student, Felipe’s knowledge in this area provides him with the capability of not only explaining the effective use of the various physical simulations Blender has to offer, but also the math and theory behind each of them. The insight provided by understanding the background behind each simulation will allow readers to most realistically portray their subjects, through understanding of the effect of each simulation parameter. Covering the topics of particles, softbodies and fluids, this is one project that will provide an great resource for all Blender users.

Michael Worcester(MickMcMack) - Introduction to Modeling

Michael’s tutorial series will be one introduced to new Blender users for a long time to come. As a ‘trail’ of tutorials through the world of modeling, Michael will begin with a detailed overview of the basics of Blender, including the various modes, the 3D cursor, and window setups, before tackling the subjects of mesh and curve modeling. Michael goes into detail, explaining the effective use of mesh functions such as spin, screw, and bevel, as well as recognising when and where to use each of these functions. A true introduction to perhaps the most important aspect of CG.

Guillermo S. Romero(GSR/UnNamed) - Introduction to Lighting

Guillermo aims to provide a gentle introduction to the basics of lighting, leading into more advanced concepts such as Ambient Occlusion and Radiosity. Starting with a review of Blender’s basic lamps and their correct usage, Guillermo plans to introduce the reader to the basic priniciples of photography and how they apply to CG lighting, as well as the role light plays in setting the mood of a scene. With the inclusion material lighting effects and Blender lamp tips and tricks, this project will certainly shed light on a topic many new CG artists have troubles with.

Willian Padovani Germano - Introduction to the Principles of Animation

With this tutorial, we’ll soon all be producing animations worthy of Pixar! Willian’s project provides a good mix between animation theory and practical Blender implementation. Referencing Disney’s ‘Illusion of Life’, this project will cover an extensive array of animation effects that simulate real life. Some of these topics include stretch and squash - volume preservation, timing, exaggeration and the animated effect of psychology on a character. Using simple-to-assemble scenes, Willian will keep the focus on the principles being described.

Colin Litster(Cog) - Introduction to Materials and Procedural Texturing

Colin, of Cogfilms, is aiming to introduce the reader to the world of realistic procedural material/texture synthesis. Beginning with the inspection and indentification of real life surface properies, and leading into their visualisation and CG approximation, Colin will cover a whole range of topics, ranging from the appropriate use of particular shaders to image mapping and displacement. The end result will be the complete transformation of a scene, changing only materials and textures.

Frédéric van der Essen(efbie) - Introduction to the Blender Database

Documenting an often misunderstood aspect of Blender, Fred’s proposal is to cover Blender’s database structure, and object-data relationship. By leading the user through a series of basic tutorials, augmented by specific documentation on each aspect, Fred aims to inform the reader how to utilise Blender’s datablock system to best effect. Often being one of the last learnt aspects of Blender, many beginners develop frustrating, painful workflows, based on assumptions made from past software experiences. This will know longer be the case, as this project set to fill the ‘documentation void’ regarding Blender’s datablock system.

Congratulations to all those who have been accepted, we look forward to seeing the end result!

BSoD Team

[edit : older Guidelines posted at http://mediawiki.blender.org/index.php/Blender_Summer_of_Documentation_Guidelines for reference]

Now THIS is awesome. A word I use very rarely

Agreed, this is fantastic. I applaud the efforts of those working on the wikipedia docs, but I’ve found it extremely hard to find the information I am looking for and it can be difficult to understand. Writing proper user-friendly documentation is HARD. Hopefully, this will help.

FINALLY. OH MY GOD I have been waiting for this for 6 years

Actually it is not clear where and how post for proposals…:slight_smile:

env: You can post in the thread at blender.org, but more information about official proposals, rules, and deadlines is on the way. I would advise anyone interested in submitting a proposal to wait a few days untill the official data is posted.

Ok, thanks.

Official guidelines for entry in the Blender Summer of Documentation can now be found on blender.org, http://www.blender.org/forum/viewtopic.php?p=53140#53140

If you are interested in being involved with this project, please read these guidelines carefully.

-Tim

Come on guys/girls!! This is the opportunity of a life time, get paid to write about the program we all know and love!!

Yeah, you’re right… Maybe I should give it a try… If I have time. How long does one writing to be?
Edit: And how many do I have to do?

I’ve so wanted some decent up to date documentation for Blender for ages, and I was tempted to apply, but I just don’t know enough about Blender to write anything for it. I wanted to assemble a project on Wikibooks but someone on here pointed out that it’d be subject to all kinds of restrictions and I should use the Blender wiki instead, only then I found out that it’s been locked down and only a few people have permission to work on it.

PassiveSmoking: If you ask LetterRip nicely he could set you up with write access

Yes, they made this topic a sticky. (aaah! Maybeabittoosticky,thewordssticktogether) I proposed for this, going to try to make some kind of a game engine tutorial, a particle tutorial and maybe a texturing tutorial too. If I got something wrong and it’s about something else than tutorials, I will laugh my *** off!!

this is one way to get quality tutorials

Hey guys,

i have a suggestion.

Wouldn’t it be great to have an inBlender-Help-Doc-Viewer ?
Maybe a Xml based viewer that provides useres with information on functions and workflows in a kind of overlay window ?

Maybe with links to the BlenderWiki and BF approvd tutorials, to get rid of soring your finger while searching for the necessary information ?

Would do this job without paying or GSoC-Approval?

Just gimme your opinions on that, or is this integration already planned ?

Greetings

Just to let everyone know, proposal deadline is now getting very close for BSoD (around 21 hrs). We have had a rather smaller response than we expected and are calling for more people to submit proposals for the project.

Everyone with the relevant background knowledge is encouraged to apply, and if time constraints for submitting your proposal are an issue, please email me personally([email protected]) and we’ll do our best to be accommodating.

-Tim

hey timmeh, i haven’t been around much, and i just noticed this thread. wish i had seen it earlier. can you tell me what areas are still needing attention?

Hey Modron!! I noticed your conspicuous absence recently…hope all is well.

Anyway, the main thing we are lacking at the moment is UV mapping, and lighting(though we do have a proposal for both, just no choices). At any rate, it’d be great if you could be involved, however, you’ve got about 3 hrs before I officially close the project to any further entries.

So get cracking!!

I am not that great at lighting, but I can certainly do UV mapping, if necessary. I don’t think I can put together a proposal in - 7 hours, but you guys may have seen one or more of my UV mapping tutorials. I recently did one on live update lscm too, that got buried somewhere in ‘general’ ( ? ) . Anyway, let me know if you guys need a hand. Sounds like you’ve got it under control.