This is an old revision of the document!


Namespaces

Here is the namespace layout, using the feedback namespace as an example.

dcss
 |
 *-> feedback
      |
      *-> branch
      |    |
      |    *-> snake pit (feedback:branch:snake_pit
      |
      *-> job
      |    |
      |    *-> berserker (feedback:job:berserker)
      |
      *-> effect
      |    |
      |    *-> silence (feedback:effect:silence)
      |
      *-> god
      |    |
      |    *-> okawaru (feedback:god:okawaru)
      |
      *-> item
      |    |
      |    *-> scroll (feedback:scroll:start)
      |         |
      |         *-> silence (feedback:scroll:silence)
      |
      *-> interface
      |    |
      |    *-> exclusions (feedback:interface:exclusions)
      |
      *-> tiles
      |    |
      |    *-> missing tiles (feedback:tiles:missing_tiles)
      |
      *-> internal
      |    |
      |    *-> RNG (feedback:internal:RNG)
      |
      *-> magic
      |    |
      |    *-> school (feedback:magic:school:start)
      |    |    |
      |    |    *-> enchantment (feedback:magic:school:enchantment)
      |    |
      |    *-> spell (feedback:magic:spell:start)
      |    |    |
      |    |    *-> silence (feedback:magic:spell:silence)
      |    |
      |    *-> system (feedback:magic:system:start)
      |
      *-> misc
      |    |
      |    *-> mutations (feedback:misc:mutations)
      |
      *-> monster
      |    |
      |    *-> naga (feedback:monster:naga)
      |    |
      |    *-> sigmund (feedback:monster:sigmund)
      |    |
      |    *-> list (feedback:monster:list:start)
      |         |
      |         *-> demons (feedback:monster:list:demons)
      |         |
      |         *-> uniques (feedback:monster:list:uniques)
      |
      *-> species
      |    |
      |    *-> naga (feedback:species:naga)
      |
      *-> vault
           |
           *-> oklob shooting gallery (feedback:vault:oklob_shooting_gallery)

This layout is mirrored by Features : Feedback & Proposal, but not by Bugs and Implementation Candidates, as that corresponds exactly to Mantis issues. Based on the above diagram, almost nothing should be more than three levels deep into the content namespace. The chain of namespaces can continue indefinitely, but new namespaces should only be added if they'll actually help in categorization. At a certain level of specificity, all relevant discussion can be fit on a single page by using subheadings:

     ~~~
      |
      *-> magic
      |    |
      |    *-> school (feedback:magic:school:start)
      |         |
      |         *-> enchantment (feedback:magic:school:enchantment)
     ~~~
                     -Enchantment school split

                     -Viability of non-stabbing enchanters

                     -Frequency of MR-immune monsters
 

Naturally, subheadings can (and should!) include links to other articles. Likewise, if initiating discussion, it would be a good idea to include links to that discussion on relevant pages. It's much better to hold discussion in one place and point to it in many places than to have a discussion scattered along a dozen pages. Feel free to move comments others have made in accordance with this principle.

Logged in as: Anonymous (VIEWER)
wiki/namespaces.1264530387.txt.gz · Last modified: 2010-01-26 19:26 by evktalo
 
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki