Campbell, I haven't dived into the python api deep enough yet, but I like the format you give here, which is:
* a specific objective/concept - overview and blender objects - how to connect from python (with working example) - where to find more info can we stick to this format all through the doc? On Sun, Jan 24, 2010 at 3:35 PM, Campbell Barton <ideasma...@gmail.com> wrote: > @Lars. > "integrate links" - This is mostly for other people to edit for a bit, > I intend to move this into sphinx eventually so wasnt interlinking > types much. > "break in flow" - Agree, I was getting impatient, it was late and I > was thinking of things people might want to know about the python api, > added this as a section but maybe can be done differently. > "context" - This definitely needs more of an explanation but confusing > with selection is not good IMHO. > > noticed some people fixed typo's but edits like adding explanation of > context is good too if someone wants to have a go, otherwise I may get > around to this. > > @Charles, new panels are always added at the end. > An error popup should show, need to fix this. > > On Sun, Jan 24, 2010 at 5:28 PM, Charles Wardlaw > <cward...@marchentertainment.com> wrote: >>> - Renaming section "context" to e.g. "User selection (Context)" might help >>> new users find/understand it faster, as "context" could mean anything if >>> you're not so familiar with the API. >> >> Hmm... I think that the idea of context is too important to link it to just >> selection. It's important to know that it's linked to both the selection >> and the tool settings, etc. Also the context isn't the same when the user >> has moused over a different view. >> >> It might be nice if there were a slightly longer explanation of how to be >> aware of context changes and how to deal with it in your python code, but I >> don't know if that's something to put on the intro page? >> >> This is a very nice intro, btw. I did get lost looking for the example >> panel, but found it eventually. It might be nice if the example panel were >> placed before the transform panel in Objects so that the person running the >> example can find it more quickly if they, like me, don't get what the code >> is doing on first glance. >> >> Also it would be nice to have the text editor display some sort of indicator >> when running scripts that shows the script was run successfully. Something >> non-modal; I like that 2.5 blocks much less than 2.4x. >> >> ~ C >> >> >> _______________________________________________ >> Bf-committers mailing list >> Bf-committers@blender.org >> http://lists.blender.org/mailman/listinfo/bf-committers >> > > > > -- > - Campbell > _______________________________________________ > Bf-committers mailing list > Bf-committers@blender.org > http://lists.blender.org/mailman/listinfo/bf-committers > _______________________________________________ Bf-committers mailing list Bf-committers@blender.org http://lists.blender.org/mailman/listinfo/bf-committers
