Difference between revisions of "Talk:Pathfinding/Alpha release notes"

From Second Life Wiki
Jump to navigation Jump to search
(moved to PATHBUG-8)
 
Line 1: Line 1:
== 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)
----
I'm a little surprised by the number of new functions.
On a wiki note, I've added some instructions to the pathfinding template to control the LSL documentation, specifically to keep tables of constants from getting links and to keep the content out of the root lsl categories (Functions, Events, Constants).
-- '''[[User:Strife_Onizuka|Strife]]''' <sup><small>([[User talk:Strife_Onizuka|talk]]|[[Special:Contributions/Strife_Onizuka|contribs]])</small></sup> 12:11, 15 February 2012 (PST)

Latest revision as of 14:04, 16 February 2012