[sldev] Adding technical documentation to the SL wiki?

Lawson English lenglish5 at cox.net
Mon Sep 3 12:54:26 PDT 2007


Rob Lanphier wrote:
> On 9/3/07 1:32 AM, John Hurliman wrote:
>   
>> I want to start documenting Second Life protocol details on the SL
>> wiki, but so far I've not been marking new pages with anything to note
>> that they are technical docs and sometimes just making paragraphs on
>> existing pages. The main benefit of the libsecondlife.org wiki for me
>> right now is a better signal to noise ratio of technical docs. If
>> there is a way to isolate things like how the network protocol and
>> viewer code actually work in to separate namespaces or the
>> wiki-equivalent it would solve this issue, so I'm looking for the
>> proper protocol on how to do this.
>>     
>
> Hmm....I don't want to break this information out into a separate
> namespace.  All of the English Wikipedia fits in one namespace, and the
> lines between "signal" and "noise" vary from person to person.  Using
> namespaces for taxonomy definition essentially hardcodes it.
>
> The right place to place this seems to be here:
> https://wiki.secondlife.com/wiki/Protocol
>
> As far as searching that goes, Google searches may be the best way to
> narrow down the search to the technical part of the wiki.  For example,
> this search:
> site:wiki.secondlife.com "open source portal" texture
>
> ...gives results only from pages that are associated with the open
> source portal.  Category tagging can help make it more specific.
>
> If there are other things Wikipedia or other MediaWiki-based wikis are
> doing, I'd rather go down that road.
>
> A couple places to take this conversation if we want to go offlist:
>
> Discussion about how to document the protocol:
> https://wiki.secondlife.com/wiki/Talk:Protocol
>
> General wiki organization:
> https://wiki.secondlife.com/wiki/Project:Editing_Discussion
>
>   

On a related note, I'm learning much about the existing classes as I try 
to figure out how to do what I want. What is the proper format for 
documenting the classes and how they are  used?




More information about the SLDev mailing list