Bob Pendleton
2004-08-03 20:13:07 UTC
http://www.libsdl.org/cgi/docwiki.cgi/FrontPage
Last night someone changed the name of a link. I'm sure they thought
they were being helpful because the link name was misspelled. The basic
idea of a wiki is that when you see something wrong or that can be
improved, you don't ask, you just fix it.
The trouble is that when you change the spelling of a link the page it
is linking to "goes away". It can no longer be reached and the wiki is
waiting for you to create a new page with the new name.
match the new link name. (The rename function is now available at the
bottom of each page.) Also and this is **VERY VERY IMPORTANT** use the
search function to find everywhere that the page is linked to and update
those links too.
OTOH, when you are creating new links, spell check them before you
create the pages they link to. To make it easy to do that, lets use
links of the form ["this is a link"] rather than using the standard wiki
words that look like ThisIsALink. Spelling checkers work pretty well on
phrases but not so well on camel case :-)
Bob Pendleton
P.S.
There are several helpful people currently adding pages to the
documentation wiki. The more help we get the faster it will be done.
http://www.libsdl.org/cgi/docwiki.cgi/FrontPage
Last night someone changed the name of a link. I'm sure they thought
they were being helpful because the link name was misspelled. The basic
idea of a wiki is that when you see something wrong or that can be
improved, you don't ask, you just fix it.
The trouble is that when you change the spelling of a link the page it
is linking to "goes away". It can no longer be reached and the wiki is
waiting for you to create a new page with the new name.
From now on, before you change the contents of a link open the page it
links to in a different tab on your browser and change the page name tomatch the new link name. (The rename function is now available at the
bottom of each page.) Also and this is **VERY VERY IMPORTANT** use the
search function to find everywhere that the page is linked to and update
those links too.
OTOH, when you are creating new links, spell check them before you
create the pages they link to. To make it easy to do that, lets use
links of the form ["this is a link"] rather than using the standard wiki
words that look like ThisIsALink. Spelling checkers work pretty well on
phrases but not so well on camel case :-)
Bob Pendleton
P.S.
There are several helpful people currently adding pages to the
documentation wiki. The more help we get the faster it will be done.
http://www.libsdl.org/cgi/docwiki.cgi/FrontPage
--
+--------------------------------------+
+ Bob Pendleton: writer and programmer +
+ email: ***@Pendleton.com +
+ blog: www.Stonewolf.net +
+ web: www.GameProgrammer.com +
+--------------------------------------+
+--------------------------------------+
+ Bob Pendleton: writer and programmer +
+ email: ***@Pendleton.com +
+ blog: www.Stonewolf.net +
+ web: www.GameProgrammer.com +
+--------------------------------------+