[Bf-committers] Copy Data Path and API doc organization

Damir Prebeg blend.factory at gmail.com
Fri May 20 13:57:23 CEST 2011


> We can have both menu items or a for submenu for Relative/Full data paths
> (ok by me, annoying it takes more room in the menu though).

Maybe always copy full path, on CTRL+V paste relative path and on
CTRL+SHIFT+V (paste special?) paste full path?

> As for docs, would be good if you could be more specific about whats
> wrong with them to give insight into making improvements.

Well, it's nothing wrong with the content, but IMO it's a bit hard to
navigate. I would like to see a hierarchical navigation through API
similar to this:

http://www.blenderhr.com/blendercoders/apilayout.html

When I click on View Docs for resolution_x, I would immediately get
all info about that value: where is located (under
bpy.context.scene.render) and that it's a member of RenderSettings
class.

Am I making any sense?

> On Thu, May 19, 2011 at 4:44 PM, Damir Prebeg <blend.factory at gmail.com> wrote:
>> But couldn't be there something like Copy Data Path -> Full | Truncated?
>>
>> Regarding tooltips, I didn't say that in them should be visible full
>> path, I'm just saying that under the tooltip is displayed something
>> completely different then you actually get when you copy data path.
>>
>> I didn't know any python before I started to use Blender. API
>> documentation with its examples has helped me a lot. Current doc
>> layout and presentation is somehow upside down for me (and I believe
>> not only for me) but that's probably matter of opinion.
>> _______________________________________________
>> Bf-committers mailing list
>> Bf-committers at blender.org
>> http://lists.blender.org/mailman/listinfo/bf-committers
>>
>
>
>
> --
> - Campbell
> _______________________________________________
> Bf-committers mailing list
> Bf-committers at blender.org
> http://lists.blender.org/mailman/listinfo/bf-committers
>


More information about the Bf-committers mailing list