Difference between revisions of "LSL functionality rating"

From Second Life Wiki
Jump to navigation Jump to search
(Created page with "== Project == The goal of this project is to improve the LSL documentation by providing a sane rating system for articles. The rating system will express how hard it is to maste…")
 
Line 7: Line 7:
===Proposal===
===Proposal===
In the summary right hover info box, add a rating field to all articles. Add a new section (subsection?) detailing how the topic is difficult.
In the summary right hover info box, add a rating field to all articles. Add a new section (subsection?) detailing how the topic is difficult.
====Rating Map====
{| {{Prettytable}}
|- {{Hl2}}
! Points
! Rating
|-
|| {{Interval|gte=0|lt=2}} || Easy
|-
|| {{Interval|gte=2|lt=5}} || Tricky
|-
|| {{Interval|gte=5|lt=8}} || Hard
|-
|| {{Interval|gte=8|lt=12}} || Expert
|-
|| {{Interval|gte=12|lt=20}} || Guru
|-
|| {{Interval|gte=20|lt=∞}} || Perverse
|}
Articles that are not rated for now will show no rating at all.


== How to rate an article ==
== How to rate an article ==


To edit the rating field you would use the difficulty template <code><nowiki>{{Difficulty|<points>|<description>}}</nowiki></code>.
To edit the rating field you would use the difficulty template <code><nowiki>{{Difficulty|points=<points>|title=<title>|<description>|<title>}}</nowiki></code>.
 
*The points and and title parameters are optional. points will default to 1.


You do not directly set the rating field, the template lets you make the topic more difficult. Ideally when adjusting a rating you won't just use the template once but for each of the reasons for why it is difficult.
You do not directly set the rating field, the template lets you make the topic more difficult. Ideally when adjusting a rating you won't just use the template once but for each of the reasons for why it is difficult. This may make it more difficult but makes it easier to catalog and edit.


Some articles will get parts of their rating from the templates they include. Functions that utilize negative indexes are a prime example.
Some articles will get parts of their rating from the templates they include. Functions that utilize negative indexes are a prime example.

Revision as of 12:32, 20 February 2012

Project

The goal of this project is to improve the LSL documentation by providing a sane rating system for articles. The rating system will express how hard it is to master and use the functionality. Secondary goals of this project are to provide a gauge for which articles need improvement and categorize them by their rating.

Articles like llSetPrimitiveParams present a challenge. It is not terribly difficult to master but it is fussy and so complex that it is difficult to use without constantly referring to the documentation. This illustrates that there are two aspects to this: difficulty and complexity. This is something we want to capture and not confuse. Beyond the base functionality and the caveats, an additional modifier is bugs. Many topics have "important issues" that modify how difficult it is to master the functionality, some are obscure edge cases, others are huge functionality changes.

Proposal

In the summary right hover info box, add a rating field to all articles. Add a new section (subsection?) detailing how the topic is difficult.


Rating Map

Points Rating
[0, 2) Easy
[2, 5) Tricky
[5, 8) Hard
[8, 12) Expert
[12, 20) Guru
[20, ∞) Perverse

Articles that are not rated for now will show no rating at all.

How to rate an article

To edit the rating field you would use the difficulty template {{Difficulty|points=<points>|title=<title>|<description>|<title>}}.

  • The points and and title parameters are optional. points will default to 1.

You do not directly set the rating field, the template lets you make the topic more difficult. Ideally when adjusting a rating you won't just use the template once but for each of the reasons for why it is difficult. This may make it more difficult but makes it easier to catalog and edit.

Some articles will get parts of their rating from the templates they include. Functions that utilize negative indexes are a prime example.