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

[Greg Zaal]

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?)
>
> _______________________________________________
> 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/20150128/15620304/attachment.htm