Talk:Pathfinding/Alpha release notes
Revision as of 12:13, 15 February 2012 by Strife Onizuka (talk | contribs)
Initial thoughts about first release of the Alpha documentation
- llCreateCharacter - TRAVERSAL_TYPE_* and CHARACTER_TYPE_* constants
- By just the names of the constants it's not immediately obvious what they do or even that they have any relation to each other.
- This may be the first occurrence of flags-that-do-things in a list (as opposed to flags-that-take-parameters-that-do-things) in LSL. I'm not sure how we will document this.
- These two issues together will effect usability and accessibility of the feature and the documentation. The changes to documentation style should overcome this but I don't have any ideas at this time as to how to go about this.
To simplify the documentation maybe change it to:
- [ CHARACTER_WALKABILITY, integer walkability_affect (slow, normal(default), fast, CURRENT, DEFAULT), integer walkability_coefficients (a, b, c, d (default), CURRENT, DEFAULT) ]
- CURRENT would be a constant that would in llCreateCharacter result in the default being used, but in llUpdateCharacter result in it ignoring the parameter.
- DEFAULT would be a constant that tells the function to use the appropriate default value for the parameter.
(I have no attachment to these names and they should probably be given more thought) -- Strife (talk|contribs) 12:11, 15 February 2012 (PST)