BattleMaster Wiki talk:Style Guide

From BattleMaster Wiki
Revision as of 12:00, 20 July 2005 by DorianGray (talk | contribs) (template positions)
Jump to navigation Jump to search

Article Length

We should really come to a decision on this topic. Namely, should we have long articles seperated into differant sections, or should we have short articles, with links to related articles? To use a more concrete example, I recently created the Meta:Page Name Guidelines, and then linked to them from the Style Guide. Should the style guide be long, explictly spelling out exactly how to do everything, or should it be short and a good overview, with links to more specific information on each topic. I'm leaning towards the latter (hence the seperate page), but what do you think? -- Nicholas July 19, 2005 19:46 (CEST)

I tend to prefer larger articles, broken up into sections which can be referred to separately. I think it's more attractive and easier to maintain than a bunch of short articles, and easier on the reader who may not always know exactly what he's looking for. For example: There's going to be a region article, but there's something to say about region commanders, gold and food production, and the various stats. It'd be better, in my opinion, for all those things to be sections under the region page. It includes all the necessary information without a lot of clicking around, and makes it less likely that someone misses an important topic by not noticing a link. --Dolohov 19 July 2005 19:59 (CEST)
A very good point, but:
  • The article on taxes already covers region gold production.
  • IMHO, it makes more sense to talk about food production in the food article. You can just add a link in the region article saying: Rural regions are the main source of food for a realm.
  • Region commanders would probably be better off described in a "lord" article.
  • You're probably right that the various stats should be described in the region article.
As far as missing an important topic. So what? Maybe a knight doesn't know why his realm needs all of those insignificant rural regions. He knows they don't give much gold to him but he wasn't interested enough to click on the food link in the region article. Oh well, he doesn't really need to know that. When his realm starts starving to death, he'll find out. Besides, ignorant nobles is probably historically accurate. :-D -- Nicholas July 19, 2005 20:37 (CEST)

There's a quite long discussion about this somewhere on the MediaWiki site. They make good arguments for long articles. The point is that it makes searching easier, it keeps stuff in one place, and prevents fragmentation, and a couple of others.
Remember that the wiki can seperate one logical page into several physical pages, and that with sections, the table-of-contents, etc., even a long article is quite accessable.
I am very much in favour of long articles. Maybe we can add short articles that only explain certain words, much like a dictionary. However, I would prefer a different style: A very short explanation at the beginning, and an in-depth discussion like what it's for, how to use it, strategy hints, etc. further down, a bit like started in the bonds article. --Tom 19 July 2005 20:52 (CEST)

Also see the new page I made about this Meta:Article structure. --Tom 20 July 2005 10:46 (CEST)

Multi Word Links

Which is the better way to name multi-word pages: TwoWords or Two_Words? It would be nice to have a consistent naming scheme for these things. -- Dolohov

I strongly think it should be [[Link_Style]]. It makes it easier to read, as the two words have some space between them. -- Nicholas July 18, 2005 22:49 (CEST)

Mediawiki doesn't do CamelCase. Use proper names. The correct page name is [[Link Style]]. Mediawiki will do the proper replacements itself. --Tom 19 July 2005 17:42 (CEST)

Mood

I think that the wiki should try to avoid using technical vocabulary as it spoils the feel of battlemaster. For example (This is all stolen from Dolohov's article on taxes. It's a great article, it just happens to be the only one available to critisize.) instead of "region's gold rating" use "region's wealth". -- Nicholas July 18, 2005 23:06 (CEST)

Oh, I agree about the technical vocabulary -- I just had no idea what to call that particular stat. I wanted to call it "production at capacity" but I didn't want to confuse it with "production". It might be useful to have a guide of RP terms for certain aspects of the game. -- Dolohov 18 July 2005 23:10 (CEST)

We might even agree to use a more "welcome my lord, I am a servant of your late father's, let me explain a few things" style... --Tom 19 July 2005 17:42 (CEST)

Capitalization

Should titles (eg Judge, Ruler, General) be capitalized? -- Dolohov 20 July 2005 02:47 (CEST)

All page titles should be capitalised, but in normal text, the normal spelling should be used, so even if the page is named "Ruler", the link is ruler. Because Mediawiki automatically capitalises the first letter of a link, this works reliably. --Tom 20 July 2005 10:45 (CEST)

template positions

I don't think anyone will speak out against having the categories at the bottom. But what about stuff like the { {stub} } mark? I've seen a few pages where it's at the bottom, and I think that is the better place, but what do you think? --Tom 20 July 2005 10:44 (CEST)

I've always preferred the stubs at the bottom. DorianGray 20 July 2005 12:00 (CEST)