[Bf-docboard] Documentation structure project

[Will DeVore]

Greetings Matt,

I understand where you are coming from. I didn't realize I was doing 
that in relation to the translators. And I also didn't realize the level 
of prose was excessive, my apologies.

Perhaps I should put myself in "park", give you the necessary time to 
complete your strategy or at the very least get it underway and pick 
back up when you signal that everything is ok.

I look forward to seeing the new structure and will make every attempt 
to follow it and, in addition, turn the prose down a great deal. ;)

As for now I am going to redirect efforts to improving my knowledge of 
the language "D" for the new few weeks. Perhaps "D" will be considered 
for core development someday, perhaps...

-Will


Matt Ebb wrote:
> Hi all,
>
> I've already sent a notice to the summer of docs mailing list, so I 
> should mention it here too.
>
> I'm going to be doing a project alongside the summer of docs, with 
> which you guys should probably be aware, and hopefully work 
> co-operatively keeping it in mind. I submitted a proposal for the 
> summer of docs, regarding the structure and information design of the 
> user manual, and although it falls outside of the 'blender basics 
> bootcamp' scope, the judges agreed that it was valuable and important 
> enough to make a special exception for it, and run the project 
> additionally. You can see the proposal here: 
> http://mediawiki.blender.org/index.php/User:Broken/SummerOfDocs2006Restructure 
>
>
> My project is partly concerned with some of the discussions that were 
> on the bf-docboard mailing list late last year with the thread 
> 'restructuring the documentation'. The part of it that would influence 
> the summer of docs most heavily is the idea of creating a stronger 
> distinction between tutorial/theory and reference content. I go into 
> more detail on this in the proposal, but basically, the mixture of 
> tutorials and reference material in the Blender documentation is the 
> source of many problems, and should be more cleanly separated (and 
> cross-linked between).
>
> Over the next days/weeks I'll be working on the points outlined in the 
> proposal, starting now with analysing the current documentation and 
> devising a template and list of items to include in it, for 
> documenting tools and options. After that, I'll start a long trawl 
> through the online manual, and will need to do a fair bit of editing 
> to implement the template and get rid of excess text. I really don't 
> want to step on anyone's feet here, so I'll try my best to stay in 
> good contact (I'm usually in #blenderwiki when I'm online) and will 
> try to keep up to date via the mailing list, so I don't interrupt 
> other people's work.
>
> Cheers
>
> Matt
> _______________________________________________
> Bf-docboard mailing list
> Bf-docboard at projects.blender.org
> http://projects.blender.org/mailman/listinfo/bf-docboard
>
>