[Bf-docboard] restructuring the Getting Started -> Interface section

[Campbell Barton]

On Wed, Jan 28, 2015 at 10:10 PM, Greg Zaal <gregzzmail at gmail.com> wrote:
> Regarding the name for the part of the screen in which an editor lives - I
> think the correct term is actually "Area": right click the border of an
> editor and see "Area Options >Split Area/Join Area"; see the tooltip for the
> button to switch areas "Current editor type for this area: 3D View". Also
> the python access is 'bpy.context.screen.areas[x]' where 'x' is the index
> for an area (e.g. for default screen layout, index of 5 is the 3D View).
>
> As for your proposed structure and moving/deleting things, looks good to me!
> Only thing that bugs me is that Scenes are a pretty fundamental aspect of
> blender and maybe shouldn't be hidden inside the interface section, though
> I'm not sure what a better place could be.
>
> On 28 January 2015 at 12:16, Gaia <gaia.clary at machinimatrix.org> wrote:
>>
>> Hi;
>>
>> I have been looking into the chapter
>>
>>      Getting Started - Basics - Interface
>>
>> This chapter contains a lot of information which
>> i believe is not exactly about the Interface but more
>> about how to use some parts of Blender.
>>
>> Based on the assumption that this chapter should
>> be about how the interface works in general
>> i propose to cut down the current structure and move
>> some documents to other places (or even delete some).
>>
>> Besides that i would like to know how to name
>> the part of the screen in which an Editor lives.
>> In the docs i find all of this:
>>
>> "Editor", "Window", "Window Frame", "Frame"
>>
>> It is not even clear to me if this means the same
>> thing in the documents or slightly different things.
>>
>> I have chosen "Frame" as a placeholder
>> for now:
>>
>> definition: Frame is a rectangular area on the
>> Blender window which hosts an Editor.
>>
>> ###############################################
>>    Proposed structure for the Interface chapter
>> ###############################################
>>
>> # Interface
>>    - Elements
>>      . principles      (done)
>>      . Screen elements (done)
>>      . Screen Layouts
>>      . Editors         (done)
>>      . Sidebars        (done)
>>      . Header          (done)
>>      . Main region     (done)
>>      . Headers
>>        - hide/show
>>        - collapse/expand Header menus
>>        - navigate
>>      . Panels          (done)
>>      . Tabs            (done)
>>      . Pinning         (done)
>>      . Data Input
>>        - Sliders
>>        - alphanumeric input
>>          Expressions
>>          Units
>>        - Color Pickers (not sure)
>>        - Eye Dropper (not sure)
>>        - Color Ramps (not sure)
>>        - Curve Widget(not sure)
>>
>>    - Input Devices
>>      . Supported devices
>>      . Recommended configuration
>>
>>    - Blender Frame System
>>      . Frames
>>      . Arranging Frames
>>      . Maximizing a Frame
>>      . Splitting Frames
>>      . Joining Frames
>>      . Change Frame Size
>>      . Swap frames
>>      . Open Frame in new Window
>>
>>    - Special Windows
>>      . The Blender Console
>> -Windows Console
>> - Linux Console
>> -Mac OS Console
>> . Operator Search (not sure)
>>      . User Preferences (not sure)
>>
>>    - Screen Layouts
>>      . The Start Screen Layout
>>      . Customizing the Start Screen Layout
>>      . Predefined Screen Layouts
>>      . Adding a new Screen Layout
>>      . Deleting a Screen Layout
>>
>>    - Scenes
>>      . Add a new Scene
>>      . Delete a Scene
>>
>> ############################
>>    Propose to move or delete
>> ############################
>>
>> I propose to move the following parts out of the Interface section:
>>
>> - The Window System is mostly a brief description
>>    of the 3D View and the Properties editor
>>
>> - From Input Devices:
>>    - Conventions -> Conventions document)
>>    - Mouse Button emulation ->Customization
>>    - NumPad Emulation -> Customization
>>    - non english Keyboard -> Internationalisation
>>
>> - From the Console Window:
>>    - Common Messages(delete)
>>
>> - Window Types (delete, done already)
>>
>> - From Screens:
>>    - Additional Layouts (delete)
>>
>> - From Scenes:
>>    - A brief Example (delete or move to a "working with scenes" document)
>>
>> - Modes (move editors/3DView)
>> - Contexts (move to editors/Properties)
>> - Buttons and controls (mostly delete)
>>    - i have added parts of this to the Data Input section (see above)
>>    - Common Shortcuts (move to conventions document?)


All seems fine with possible exception of `Data Input` for sliders, buttons...

These were split up into 2 sections on purpose, since curves,
colorbands etc - are really small editors themselves (have their own
keybindings and selection).

And name 'Data Input' is a bit odd (its really IO :) ), but we could
just name buttons or widgets?

-- 
- Campbell