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

From Second Life Wiki
Jump to navigation Jump to search
m (Initial thoughts about first release of the Alpha documentation)
 
m
Line 6: Line 6:
** 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.
** 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 speed_affect (slow, normal(default), fast, CURRENT, DEFAULT), integer walkability_coefficients (a, b, c, d (default), CURRENT, DEFAULT ]
To simplify the documentation maybe change it to:
* [ CHARACTER_WALKABILITY, integer speed_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.
* CURRENT would be a constant that would in llCreateCharacter result in the default being used, but in llUpdateCharacter result in it ignoring the parameter.

Revision as of 13:12, 15 February 2012

Initial thoughts about first release of the Alpha documentation

  • llCreateCharacter - TRAVERSAL_TYPE_* and CHARACTER_TYPE_* constants
    1. 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.
    2. 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 speed_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)