Skip to Content.
Sympa Menu

sm-discuss - [SM-Discuss] Details and Integrity Checking Reference documentation review request

sm-discuss AT lists.ibiblio.org

Subject: Public SourceMage Discussion List

List archive

Chronological Thread  
  • From: Donald 'minozake' Johnson <ltdonny AT gmail.com>
  • To: sm-discuss AT lists.ibiblio.org
  • Subject: [SM-Discuss] Details and Integrity Checking Reference documentation review request
  • Date: Sat, 10 Jul 2010 03:27:08 -0500

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hey, Valley,

I am attempting to write reference documentation to replace the current
spell script pages for all of the files found in a script directory of a
spell. Namely, I need reviews upon it now, as I can't improve it any
more than I have it.

I opted for a general rewrite of this documentation, since editing the
currently-used pages would be a nightmare to refactor from a tutorial
type to a reference type of documentation. MoinMoin syntax likes to get
in the way.

The main things I am looking out for are:
-How is the conciseness of each part of the reference?
-Am I missing information, such as variables, explanations of what's
happening, etc.?
-Anything else that bugs you?

What you should do, any, some, or none:
-Edit the page to put in missing information or edit to style it
better.
-Don't worry too much about Documentation Guidelines with your
edits.
-Reply to this email so I can add it (if you're lazing about :P)
-Criticize everything you feel like. Remember, though, I probably
copy and pasted this from the API, modifying it to fit the page.
The API should be blamed second, first to my not noticing it.
-Fix or email about formatting issues. MoinMoin syntax has very bad
oddities.
-Have Fun. (^,^)b

Hopefully this will better the Source Mage GNU/Linux documentation in
that less people have to ask on IRC about the API, or refer to the code
itself. So far, it's gotten use out of me when I've had to edit spells,
despite only describing two parts of a spell.

Documentation pages to review are:
-<http://sourcemage.org/Tome/Workshop/DetailsReference>
-<http://sourcemage.org/Tome/Workshop/IntegrityCheckingReference>

There shall be more pages in the coming months. All WIP pages from Tome
are present at <http://sourcemage.org/Tome/Workshop> for anyone to edit.

Thank you,
~Donald 'minozake' Johnson
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.10 (GNU/Linux)

iQEcBAEBAgAGBQJMOC7SAAoJEK6T5YiOgP7RiqMH/jk7jMzYAZXEKpTdXPPuYt/A
42d/uqR/+aNURNpsvnA/eXr/y0lTs4T5hW+3BORBPcMBgXnWAhH0xEMMa3WzZJnZ
3ff2qq59g5xZn2wFs/639XMUOqJF1VoGFzDXI3Rlu0Lko+hfcYqU+YshOsYHG52A
fTaACPXnB4REHLGYUOjpqvlAa9qFHjef85tK8a+shxw7YdZnd79pimcm8N4qRrOZ
4kOd7xnECLQ+0uecK9APO5WIlDrDIHq/WeL5Axkf5PFxipEQCy7pjiAz18ly83mO
KrNe+BfqvWYgPJHwAG+xDoQDiVLyNSUnUzSKBZYjILH7bXEySUrvP31Oq+w9qbw=
=Hd2U
-----END PGP SIGNATURE-----




Archive powered by MHonArc 2.6.24.

Top of Page