If you are interested in writing Official documentation!

Discussion related to the development of project wide documentation and tutorials.
Coordinator: 'Abel'

Moderator: coordinators

Re: If you are interested in writing Official documentation!

Postby Lord Crc » Thu Aug 18, 2011 11:48 pm

Thanks hoodedman!
May contain traces of nuts.
User avatar
Lord Crc
Developer
 
Posts: 4455
Joined: Sat Nov 17, 2007 2:10 pm

Re: If you are interested in writing Official documentation!

Postby hoodedmanwithsythe » Fri Aug 19, 2011 9:06 pm

Abel wrote:
hoodedmanwithsythe wrote:I'm in the process of updating a number of the old LuxBlend Tuts to LuxBlend25 and I'll be adding a number of new ones on the way.

Great, thanks! I've added a link to your new Sun, Sky and HDRI page on the wiki front page.

Hey Abel, it was already under the luxblend25 section - you've just added it under the blender2.49 section.
Timothy Armstrong,
-----------------
Entrepreneurial Philanthropist
User avatar
hoodedmanwithsythe
FOSS Hippy
 
Posts: 273
Joined: Thu Feb 04, 2010 7:05 pm
Location: Rotterdam

Re: If you are interested in writing Official documentation!

Postby Abel » Sat Aug 20, 2011 4:26 am

hoodedmanwithsythe wrote:Hey Abel, it was already under the luxblend25 section - you've just added it under the blender2.49 section.

Oops, I've reverted my changes and added more 2.49 labels instead so I won't get confused that easily next time. :)

I've split off the IBL discussion to a new topic: viewtopic.php?f=16&t=6875&p=69920#p69920
User avatar
Abel
Developer
 
Posts: 1414
Joined: Sat Oct 20, 2007 8:13 am
Location: Helsinki, Finland

Re: If you are interested in writing Official documentation!

Postby hoodedmanwithsythe » Sat Aug 20, 2011 12:29 pm

Abel wrote:
hoodedmanwithsythe wrote:Hey Abel, it was already under the luxblend25 section - you've just added it under the blender2.49 section.

Oops, I've reverted my changes and added more 2.49 labels instead so I won't get confused that easily next time. :)

I've split off the IBL discussion to a new topic: viewtopic.php?f=16&t=6875&p=69920#p69920

I'm going to split off the blender2.5 section on the main page and give it it's own section like the blender 2.49 section once we have a few more tutorials to file there.
We could also do with enough tutorials for the other exporters to have a reason to split them off too. Perhaps a separate exporters page sub-tree could be warranted then?
Timothy Armstrong,
-----------------
Entrepreneurial Philanthropist
User avatar
hoodedmanwithsythe
FOSS Hippy
 
Posts: 273
Joined: Thu Feb 04, 2010 7:05 pm
Location: Rotterdam

Re: If you are interested in writing Official documentation!

Postby Abel » Sat Aug 20, 2011 1:42 pm

I'm not exactly sure what "separate exporters page sub-tree" means, but I'm looking forward to the situation that we have so many tutorials that organising them becomes an issue. :)
User avatar
Abel
Developer
 
Posts: 1414
Joined: Sat Oct 20, 2007 8:13 am
Location: Helsinki, Finland

Re: If you are interested in writing Official documentation!

Postby hoodedmanwithsythe » Sun Aug 21, 2011 2:32 pm

Abel wrote:I'm not exactly sure what "separate exporters page sub-tree" means, but I'm looking forward to the situation that we have so many tutorials that organising them becomes an issue. :)

The idea is that it would be a separate page that just contains tutorials, where as the current main documentation page would only hold the exporter manuals. The separation would make handling a large volume of tutorials easier for the reader to search though.
Timothy Armstrong,
-----------------
Entrepreneurial Philanthropist
User avatar
hoodedmanwithsythe
FOSS Hippy
 
Posts: 273
Joined: Thu Feb 04, 2010 7:05 pm
Location: Rotterdam

Re: If you are interested in writing Official documentation!

Postby Abel » Sun Aug 21, 2011 4:37 pm

That sounds good, by that time we could also include some images to make the tutorials more recognisable.
User avatar
Abel
Developer
 
Posts: 1414
Joined: Sat Oct 20, 2007 8:13 am
Location: Helsinki, Finland

Re: If you are interested in writing Official documentation!

Postby hoodedmanwithsythe » Sun Aug 21, 2011 8:37 pm

Abel wrote:That sounds good, by that time we could also include some images to make the tutorials more recognisable.

Quite - still some way to go yet though. We need to encourage more tutorials perhaps we could incorporate them into the contests some how - perhaps the winner could be encourages to write a tutorial on one or more of the materials in the winning scene? this would need further discussion.
Timothy Armstrong,
-----------------
Entrepreneurial Philanthropist
User avatar
hoodedmanwithsythe
FOSS Hippy
 
Posts: 273
Joined: Thu Feb 04, 2010 7:05 pm
Location: Rotterdam

Re: If you are interested in writing Official documentation!

Postby cseder » Fri Jul 06, 2012 3:32 pm

Hello there!

I could donate some of my spare time to writing documentation for Lux Render project!
I've used 3D applications since around 2006, mainly commercial ones, but recently switched to Blender.
You can read about my experiences on my blog: http://baltazaar.wordpress.com

Anyways, I've been programming some Python and a tiny bit of C and C++ and I'm currently reading the
"Physically Based Rendering, from Theory to Implementation" by Matt Pharr and Greg Humphreys and I think
it would be a good preparation for thoroughly understanding the Lux Renderer core concepts.

I don't know how much time I can devote to this project, but I'd really like to help out!

Please give me some instructions as of where to start off!

NB! I'll be away for the coming week, but I'll be back around July 16.

Have a nice summer!
Remember:
The Time is NOW!
User avatar
cseder
 
Posts: 1
Joined: Tue Jun 19, 2012 3:10 pm
Location: Terra Incognita

Re: If you are interested in writing Official documentation!

Postby Abel » Fri Jul 06, 2012 5:01 pm

cseder wrote:I could donate some of my spare time to writing documentation for Lux Render project!

Great! Judging by your blog and experience, I'm sure you'll manage to make some meaningful contributions. :)

There is a whole todo list of stuff that needs to be done (http://www.luxrender.net/wiki/Documentation_todo) and before getting started it would be nice to have a quick look at this page: http://www.luxrender.net/wiki/Wiki_HowTo_and_Guidelines - in particular the part about the division between exporter specific documentation and general documentation.

As we're approaching the 1.0 release, it probably makes sense to check recent LuxBlend improvements (for example by checking changelogs, or just by visual comparison) and document those. It would be good to add notes that those functions will appear with LuxRender 1.0 as not to confuse users of version 0.8.

Apart from the LuxBlend documentation, the general documentation can always use better rendered examples and there is a whole bunch of rendering settings that are hardly documented. As you're reading the book and trying to get a thorough understanding of the rendering process, you could probably shed some light on a couple of those, although there is also a lot of functionality that is not in PBRT.

Finally, tutorials tend to get outdated as their authors create them for a particular version but rarely update them later. Updating those to the latest version is somewhat tedious, but at the same time possibly an easy way to get started.

If you have any questions or doubts, just ask. Good luck and thanks in advance! :)
User avatar
Abel
Developer
 
Posts: 1414
Joined: Sat Oct 20, 2007 8:13 am
Location: Helsinki, Finland

PreviousNext

Return to Documentation & Tutorials

Who is online

Users browsing this forum: No registered users and 1 guest

cron