Difference between revisions of "Help:Editing Guidelines"

From The Authentic D&D Wiki
Jump to navigationJump to search
m
 
(44 intermediate revisions by 6 users not shown)
Line 1: Line 1:
== Suggestion ==
+
== Priorities ==
  
Should we move this page to [[Help:Editing Guidelines]]? The [https://www.mediawiki.org/wiki/Help:Namespaces#Help Help] namespace may be useful to keep these "non-wiki" instructional meta-pages collected. Namespaces in general could be very useful overall. --[[User:Shelby038|Shelby038]] ([[User talk:Shelby038|talk]]) 00:20, 13 February 2020 (UTC)
+
(1) Copy over Monsters, Spells and Sage Abilities pages.  Declare your territory and then stick to it, until it is over.  Carl, I know, is working on Cleric spells.  Shelby is working on Monsters.  Call Illusionist Spells, Mage Spells, Druid Spells, Bard Spells or Cantrips.  Or if you feel bold, call Sage Abilities — but take note, don't feel the need to expand on the abilities (leave that for me).
 +
:Shelby2 is calling Cantrips
 +
::So noted. --[[User:Tao alexis|Tao alexis]] ([[User talk:Tao alexis|talk]]) 19:51, 9 March 2020 (UTC)
 +
:I'm done with Cleric spells. I can jump on Mage spells. SimonTVesper 19:47, 9 March 2020 (UTC)
 +
::Could you tackle the bard first? --[[User:Tao alexis|Tao alexis]] ([[User talk:Tao alexis|talk]]) 19:51, 9 March 2020 (UTC)
 +
:::Can do. SimonTVesper 19:58, 9 March 2020 (UTC)
  
== Templates ==
+
(2) Add links to existing pages, correct spelling errors, and please check your links if you're cutting and pasting from the old blog wiki.  Very often, the links from the old wiki are broken or the names have been changed for this wiki.
  
I've created a [[Template:Bestiarychart|template]] for use for Bestiary stat blocks. I think templates are crucial for design as they allow quick changes in one location only, rather than needing to change every page where they are used. They are a big part of the wiki system. For example, we discussed the background color of the block. If we desired to change that color later, it can simply be done from the Template page. More than that, if later we wanted to format it more like the originals from the blog, that could be done without editing each creature's page. Check out the [[Alpaca]] page for an example of its use. I suggest this be done for any case where the same type of block is likely to be used: spells, for instance. --[[User:Shelby038|Shelby038]] ([[User talk:Shelby038|talk]]) 00:20, 13 February 2020 (UTC)
+
(3) Someone please teach me how to tag pages that I've edited. Shelby, you mentioned how to sign off on a Talk page comment; but I missed it. Describe that process to me also, please.
:SureBut I don't know how they workI don't mind telling you, Shelby; my skill is in writing and design, NOT in html and programming; I'm learning all I can, but it isn't enough to just tell me something is good. I also need to know how it actually functions; what do I do with the template?  Does cutting and pasting it to a new page ensure that a quick change affects all of them?
+
:You insert it by using the button that looks like a doodle. It is located in the formatting menu between the italics and link buttons. It is not available on all pages (not on this one) maybe because it is only on with the "talk:" namespace. It is still possible to insert it though. Just type four tilde symbols [[User:Sebastian|Sebastian]] ([[User talk:Sebastian|talk]]) 11:31, 15 February 2020 (UTC)
::In general templates are used as:
+
 
<pre>
+
== Editorial Guidelines ==
<nowiki>{{templatename
+
 
| parameter = value
+
Where possible, please correct minor details on wiki pages.
}}</nowiki></pre>
+
 
::Mediawiki finds "templatename," (in this example, Bestiarychart) and gives it the parameters and values that you've supplied. This ensures that all formatting remains the same, because Mediawiki only checks a single place for the formatting: the template source. What I will do (pending approval) is copy what I've shown on the Alpaca page, and modify it for each creature. I'd suggest to read [https://www.mediawiki.org/wiki/Help:Templates Help:Templates] but honestly it's quite dense; the "Creation" section is the only part written in half-way understandable English.
+
:* if you find "~", "-" or "--" used as a dash, please replace it with an em dash found under special charactersPlease put a blank space on either side of the em dashDo this: "if — then", not "if—then".
 +
:* Use ordinals without superscript to describe experience levels: always say, "1st level", not "first level." (a mistake I tend to make, but would rather not).
 +
:* Please do not use ' for feet or " for inches.  These should be written "ft." or "in."  In tables, diameter can be shortened to "diam."
 +
:* The phrase "to hit" does not need to be written inside single quotes (but link it to the page, "roll to hit").
 +
:* If a spell has an effect or duration with a base number and an added number per level, this should be written with a space between the first number and the addition: "2 +2/level" ... it should not be written, "2+2/level".  This should be standard in other similar situations.
 +
:* The first time a post refers to [[Action Points|action points]], please write this as "action points (AP)"; thereafter, use "AP."  If the post does not use action points a second time in the course of the post, do not include the shortened form the first time the rule is quoted.
 +
:* "hp" is acceptable; it does not need to be "h.p.", but the latter is acceptable. Please do not use "exp.", "x.p." or "XP" to describe experience.  It should be "X.P." or written out.  If space is an issue, rounds may be shortened to "rnd" or "rnds"; level may be shortened to "lvl" or "lvls".  I can't think of an example where space would be an issue.
 +
:* There should be no period following links set aside at the bottom of the page.
 +
:* Please be sure to put a period after "ft."  Not "ft";  also, "lb." or "lbs."  Also, "cubic ft." should be "cub.ft."  Also, "cubic yard" should be "cub.yd."
 +
:* Please do not use superscript ordinals.  These should be written "1st," not "1<sup>st<sup>."
 +
 
 +
== New Business ==
 +
Apart from the above, there is no new business at this time.  If you would like to add to the priorities above, please email me at alexiss1@telus.net, explain the policy you would like to implement, and we'll discuss its implementation.

Latest revision as of 19:58, 9 March 2020

Priorities

(1) Copy over Monsters, Spells and Sage Abilities pages. Declare your territory and then stick to it, until it is over. Carl, I know, is working on Cleric spells. Shelby is working on Monsters. Call Illusionist Spells, Mage Spells, Druid Spells, Bard Spells or Cantrips. Or if you feel bold, call Sage Abilities — but take note, don't feel the need to expand on the abilities (leave that for me).

Shelby2 is calling Cantrips
So noted. --Tao alexis (talk) 19:51, 9 March 2020 (UTC)
I'm done with Cleric spells. I can jump on Mage spells. SimonTVesper 19:47, 9 March 2020 (UTC)
Could you tackle the bard first? --Tao alexis (talk) 19:51, 9 March 2020 (UTC)
Can do. SimonTVesper 19:58, 9 March 2020 (UTC)

(2) Add links to existing pages, correct spelling errors, and please check your links if you're cutting and pasting from the old blog wiki. Very often, the links from the old wiki are broken or the names have been changed for this wiki.

(3) Someone please teach me how to tag pages that I've edited. Shelby, you mentioned how to sign off on a Talk page comment; but I missed it. Describe that process to me also, please.

You insert it by using the button that looks like a doodle. It is located in the formatting menu between the italics and link buttons. It is not available on all pages (not on this one) maybe because it is only on with the "talk:" namespace. It is still possible to insert it though. Just type four tilde symbols Sebastian (talk) 11:31, 15 February 2020 (UTC)

Editorial Guidelines

Where possible, please correct minor details on wiki pages.

  • if you find "~", "-" or "--" used as a dash, please replace it with an em dash found under special characters. Please put a blank space on either side of the em dash. Do this: "if — then", not "if—then".
  • Use ordinals without superscript to describe experience levels: always say, "1st level", not "first level." (a mistake I tend to make, but would rather not).
  • Please do not use ' for feet or " for inches. These should be written "ft." or "in." In tables, diameter can be shortened to "diam."
  • The phrase "to hit" does not need to be written inside single quotes (but link it to the page, "roll to hit").
  • If a spell has an effect or duration with a base number and an added number per level, this should be written with a space between the first number and the addition: "2 +2/level" ... it should not be written, "2+2/level". This should be standard in other similar situations.
  • The first time a post refers to action points, please write this as "action points (AP)"; thereafter, use "AP." If the post does not use action points a second time in the course of the post, do not include the shortened form the first time the rule is quoted.
  • "hp" is acceptable; it does not need to be "h.p.", but the latter is acceptable. Please do not use "exp.", "x.p." or "XP" to describe experience. It should be "X.P." or written out. If space is an issue, rounds may be shortened to "rnd" or "rnds"; level may be shortened to "lvl" or "lvls". I can't think of an example where space would be an issue.
  • There should be no period following links set aside at the bottom of the page.
  • Please be sure to put a period after "ft." Not "ft"; also, "lb." or "lbs." Also, "cubic ft." should be "cub.ft." Also, "cubic yard" should be "cub.yd."
  • Please do not use superscript ordinals. These should be written "1st," not "1st."

New Business

Apart from the above, there is no new business at this time. If you would like to add to the priorities above, please email me at alexiss1@telus.net, explain the policy you would like to implement, and we'll discuss its implementation.