[Bf-docboard] VSE new structure

[Raindrops From Sky]

Hi,

This version has come out nicely.

A tip: When you are already providing an image, then it is best to annotate
it with marker numbers and then refer to those numbers in the text.
If necessary, use a rectangle/oval overlay to highlight a specific control
(or region of interest) in the GUI.

Then you will not have to say "The upper-left window pane is the Graph
Editor, the upper-right window pane is the....".
(If you were presenting a ppt, would you talk like that? of course not- You
would use a laser pointer and point at specific areas...)

****
Your page names and headings do not match with the convention followed by
the wiki.

First of all, the contents of the
http://wiki.blender.org/index.php/Meta:Sanbox/Doc:2.6/Manual/Sequencer page
will go to the main index page:
http://wiki.blender.org/index.php/Doc:2.6/Manual#Editing_Sequences

Thereafter, all your pages will get called from the manual's main index
page.
So the
http://wiki.blender.org/index.php/Meta:Sanbox/Doc:2.6/Manual/Sequencer page
would be retired (not needed; redundant).

*****
I will provide two examples of how to change the banner (text in orange
band at the top of page).
Apply the same method to the other pages also.

First example: page Doc:2.6/Manual/Sequencer/Intro/Introduction.

Change its banner to "Doc:2.6/Manual/Video Sequence Editor"
Reason: The intro pages are not called "introduction", but named after the
main topic.

Change the first heading on the page "Introduction to video editing in
Blender" to simply "Introduction" (h1 format).
----
A second example: The Doc:2.6/Manual/Sequencer/Strips/Types page-

Change the banner from  "Doc:2.6/Manual/Sequencer/Strips/Types" to
"Doc:2.6/Manual/Sequencer/Strips/Introduction".
Change the title "Strips definition and type" to "Introduction".

****
The overview page should cover the display modes, because it accomplishes
different tasks in each mode.
BTW the screenshot of each mode should show the entire VSE, not just its
header (which does not explain what that mode is for).
Explain the main purpose of each mode, and explain how the GUI helps
achieve that.

Then the next page will only have a brief explanation about the workflow
(important!) which modes to use to achieve that workflow.

Therefore this section ("View") should be renamed "Working with VSE".

*****


Regards,
Narayan




On Wed, Jun 5, 2013 at 9:30 PM, Polosson <polo at citadelrock.fr> wrote:

>  Hi all !
>
> I finally finished the new structure / complete update of the 2.6 VSE
> chapter.
>
> I need someone to tell me: *"OK, you can move this from the sandbox to
> the Doc:2.6 pages"*, or *"no way, your work sucks"*... :P
>
> BTW, here is the "index" page I created for it in the sandbox:
> http://wiki.blender.org/index.php/Meta:Sanbox/Doc:2.6/Manual/Sequencer
> Note that the links inside are pointing to the final page's destinations
> (i.e. Doc2.6)
>
> A question anyway, concerning the "tree view" in the left panel of the
> wiki... How to update it ? It'd be better if this tree would be the same as
> the "index" page I created...
>
> All critiques and remarks are welcome... And since I soon would no longerhave time
> to take care about that, everyone can update / change / correct it !
>
> Thanks !
> .Polo
>
> --
> Polosson, ingénieur du son et web-développeur <http://www.polosson.com>
>
> _______________________________________________
> Bf-docboard mailing list
> Bf-docboard at blender.org
> http://lists.blender.org/mailman/listinfo/bf-docboard
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.blender.org/pipermail/bf-docboard/attachments/20130605/97f2c194/attachment.htm