Difference between revisions of "SLGOGP Draft 1/Discuss 1 Structure"

From Second Life Wiki
Jump to navigation Jump to search
Line 1: Line 1:
Welcome!
Welcome!
== Contribution agreement ==


== Structure ==
== Structure ==

Revision as of 12:48, 13 March 2008

Welcome!

Contribution agreement

Structure

  • The structure of this wiki page for the specification seems to be somewhat closed to community contribution:
  • The inability to modify the parent document destroys most of the utility of wikis.
  • Since our contributions can now only be made in the discussions sections, they become merely advisary, and hence will be mostly ignored.
  • This is not really a community approach to evolving a document, as it divides the AWG into Lindens with power over the document and minions with none, and so it does not encourage contributions.
  • The worst aspect of this by far however is that the protocol specification becomes the exclusive domain of Linden Labs, and not of the AWG. Since the document is not defining Second Life but is creating a generic interoperable protocol for all parties, it is inappropriate that this specification be under the sole control of Linden Labs. Morgaine Dinova 22:11, 11 March 2008 (PDT)
  • It has been suggested that the current structure is just a first-cut prototype. That's fine, but the above points stand, currently. Morgaine Dinova

Terminology

  • I think we should use the nomenclature of RFCs here as it makes quite clear what one has to implement and what is optional. Here is the sentence from the OAuth spec: The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in [RFC2119] (Bradner, B., “Key words for use in RFCs to Indicate Requirement Levels,” .). Domain name examples use [RFC2606] (Eastlake, D. and A. Panitz, “Reserved Top Level DNS Names,” .). TaoTakashi 09:13, 13 March 2008 (PDT)
  • a glossary might be very helpful, e.g. what is a client, a viewer, agent domain etc. TaoTakashi 09:15, 13 March 2008 (PDT)