Difference between revisions of "Help:Editing Guidelines"

From The Authentic D&D Wiki
Jump to navigationJump to search
(→‎Suggestions: new suggestions)
 
(40 intermediate revisions by 5 users not shown)
Line 1: Line 1:
== Policies ==
+
== Priorities ==
  
=== New pages policy ===
+
(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).
Pending an official Alexis pronunciation, all users are hereby discouraged from creating new pages if the title is not already created. At least on the main namespace. I understand templates might be more flexible (but see upper section on those). Statement pending of official revision [[User:Scarbrow|Scarbrow]] ([[User talk:Scarbrow|talk]]) 10:12, 14 February 2020 (UTC)
+
: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/ programming / arcana policy ===
+
(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.
Pending an official Alexis pronunciation, all users are hereby asked politely to '''not''' add unnecessarily complicated wikicode / wikitext / wiki markup to the pages, until and unless Alexis has given official permission. See on [[Template_talk:Bestiarychart]] for the (always impassioned) impressions of our host about this. Statement pending of official revision [[User:Scarbrow|Scarbrow]] ([[User talk:Scarbrow|talk]]) 10:12, 14 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.
 +
: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)
  
== Suggestion ==
+
== Editorial Guidelines ==  
  
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)
+
Where possible, please correct minor details on wiki pages.
  
== Templates ==
+
:* 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|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>."
  
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)
+
== New Business ==
:Sure.  But I don't know how they work.  I 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?
+
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.
::In general templates are used as:
 
<pre>
 
<nowiki>{{templatename
 
| parameter = value
 
}}</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.
 
 
 
== Herding cats / Meta coordination ==
 
Hi all! Since I'm new, and I don't want to step on anybody's toes, I've gone ahead, been bold and tried a coordinating effort. Alexis, you can berate me for that. All the rest, you can berate me too! I'm just a newcomer. BUT I used to be a wiki admin. It just comes second nature. Hope nobody takes offense. Please remember, to keep the flow of conversation easy to read, to sign your comments with four tildes (<nowiki>~~~~</nowiki>) [[User:Scarbrow|Scarbrow]] ([[User talk:Scarbrow|talk]]) 10:12, 14 February 2020 (UTC)
 
 
 
As a further suggestion, new suggestions (that aren't by themselves suggestions of new policies) should be added as sections below this one. Policies, however, should be listed at the top. [[User:Scarbrow|Scarbrow]] ([[User talk:Scarbrow|talk]]) 10:12, 14 February 2020 (UTC)
 
 
 
== Suggestions ==
 
 
 
=== CSS ===
 
Alexis, a suggestion. The current typeface on pages seems a little small. I think it may be tweaked through [[MediaWiki:Common.css]]. Would you mind me trying it? Or else, I can just tweak the zoom on my browser. I don't know if this is an issue for anybody else. Comments? [[User:Scarbrow|Scarbrow]] ([[User talk:Scarbrow|talk]]) 10:12, 14 February 2020 (UTC)
 
 
 
=== Category tree ===
 
Wikis can show a [http://wiki.alexissmolensk.com/index.php/Special:CategoryTree Category tree] for the purposes of exploration. You can see it in action, for example, in [https://sryth.fandom.com/index.php?title=Special%3ACategoryTree&target=Browse&mode=categories&dotree=Show+tree my old wiki]. This tree can be expanded from any branch, but it is convenient for it to have a clear "root" category.
 
* Would you agree, Alexis? And if yes, what should the name of the root category for this wiki be?
 
* Do you have any idea of a category system you plan to use? I was thinking of making one category for every "label" on the Blogspot wiki. Would that be right?
 
[[User:Scarbrow|Scarbrow]] ([[User talk:Scarbrow|talk]]) 10:48, 14 February 2020 (UTC)
 
 
 
=== Placeholder category ===
 
I'd like to remove the [[:Category:Placeholder|Placeholder]] category. Since all of its elements seem to be bestiary entries, I propose categorizing those pages as [[:Category:Bestiary]]. Thoughts? [[User:Scarbrow|Scarbrow]] ([[User talk:Scarbrow|talk]]) 10:48, 14 February 2020 (UTC)
 
 
 
=== Importing maintenance templates ===
 
I know you're against unnecessarily complicated wiki code, Alexis. But many templates are very useful, very easy to use, and all of their complexity can be safely abstracted from the end user. Even more, most of them are fully optional to use, but still useful for power users. A paramount example is [https://en.wikipedia.org/wiki/Template:Tl Template:T], but there are many others. I had a [https://sryth.fandom.com/wiki/Category:Auxiliary_templates full toolbox] of those in my old wiki. Others are useful for maintaining purposes, like [https://sryth.fandom.com/wiki/Template:Delete Template:Delete] (not using the Wikipedia example here, since it's much, much too complicated for our use). Other still are used for notices, like [https://sryth.fandom.com/wiki/Template:Underconstruction UnderConstruction]. Would you oppose the creation of some of these in this wiki, Alexis? All of them would be fully documented, and none of those would be required material, so in the worst case, you can just ignore them. [[User:Scarbrow|Scarbrow]] ([[User talk:Scarbrow|talk]]) 10:48, 14 February 2020 (UTC)
 

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.