User:BadCatMan/Manual of Style

This Manual of Style is a style guide offering guidelines for writing, formatting, and organizing articles on the Forgotten Realms Wiki, to promote a consistent style that suits wiki policies.

These are based on standard wiki style and on habits developed by FRW editors to suit the Forgotten Realms setting and the wiki's goals. Some are set by our policies, while others are not mandatory but are commonly used. An editor might not use some of these on an article, but should be aware that another editor may eventually apply it.

See Wikipedia's Manual of Style for more detailed guidelines. Ask User:BadCatMan for clarifications and advice.

But some articles…
No, some existing articles don't employ these styles. These articles were mostly written before these policies and habits were developed or enforced, while others slipped through the net later. This does not mean the bad habits they show are okay, only that we have quite a backlog to get through. We hope to eventually bring all these articles up to a consistent style and good quality. If you see any, try fixing it up yourself.

In-universe
An in-universe article is one about the fictional lore of the Forgotten Realms or another setting and the Dungeons & Dragons game. A common fan term for this is "fluff" (as opposed to the "crunch" of rules and statistics; see Crunch, below, for how to handle this). This includes characters, creatures, places and areas, events and history, spells, items, and even classes. An in-universe article shouldn't mention crunch, novels, sourcebooks, and so on. These are obtrusive; coming across these breaks the reader's suspension of disbelief, reminding them that they are not reading about a world, but about a book or game. See Help:Citing sources for how to cite a novel in an unobtrusive way, through footnoted references.

Perspective
Write in-universe articles from an in-universe perspective, that is, the point-of-view (POV) of someone in the setting. That person can't see the novel something was written in, they can't see the game rules, or the level of a character. So don't mention these things. That person, being essentially the reader, is otherwise omniscient, however; they know everything else that went on. But, because of our past tense policy, below, all these things occurred in the past. If it helps, imagine yourself as a sage living centuries in the future of the setting, after everything has changed, collecting and compiling all these records of the past.

That said, you should also write from the third-person point-of-view. For example, "she did this". There's no need to go into character with a first-person POV ("I saw this") or address the reader or player with a second-person POV ("You see this"). This provides a neutral perspective.

Tense
Owing to our Remove Wiki from the Timeline policy, all in-universe articles must be written in past tense. So, not "Elminster slays the dragon and flies to Cormyr" (present tense), but "Elminster slayed the dragon and flew to Cormyr" (past tense). In the first case, both events seem to happen at once, which doesn't make sense. Some users employ an odd conditional-future tense with "would", as in "Elminster would slay the dragon and would fly to Cormyr" but this sounds even stranger, suggesting Elminster only planned these things, but did not necessarily do them. Only the past tense makes it clear that these things actually happened in the story: "Elminster slayed the dragon then flew to Cormyr" is clearest and simplest. Saying "Ravens Bluff was a city in the Vast" does not mean it has been destroyed in the latest edition (it hasn't), only that it was a city then and was a city up to when we last heard of it.

As an exception, the present tense is used in articles about individual years, following the custom of chronologies presented in the sourcebooks and on Wikipedia. For example, from -286 DR, "The Xothol arcane college is closed." and "Wulgreth of Netheril settles in the ruins of Karse." The present tense can also be used when referring to real-world topics, e.g., "the rapier is a sword with a thin pointed blade", as this is a real item currently existing in our world. It can also be used when information is unknown, e.g., "The outcome of this battle is unknown", meaning it is unknown to the article writer or reader, but may be known to characters in the setting. This should be used with discretion. The main body of the article and in-universe lore should still be in past tense.

Other tenses can still be used for more complex events: "Elminster would have slayed the dragon, but it was immune to his magic." (a conditional future tense for events that were planned) and "Smuggling had been going until 1375 DR when paladins put a stop to it." (the past perfect continuous tense, for events that took place for some period of time until some point in the past). This is just normal grammar.

What happened next?
Adventure modules and video games often present events for which the outcome is not set in stone. Players may have several options for completion, or may choose to do almost anything. Events will turn out differently for each player and gaming group. Readers may also want to see their own characters behind these events, or they may want to see all possible outcomes so they can choose which occurred for their game. Often, there is no canonical confirmation of how things played out. Therefore, try to give all the outcomes and options presented in the game or module.

There are several ways to go about this. One is to write the article up to the point the characters and location are in at the beginning of play. For example, The Green Lady leaves her in the state she is in when players are expected to find her. An out-of-universe note is included in the Appendix to explain that there is no official resolution, but mentions what will happen if PCs progress successfully. This is the simplest solution, and is most useful when there is no clear outcome.

If the game assumes only one outcome, then you may go further. For example, "Adventurers investigating Dura's death discovered the Green Lady and roused her from her depression, before learning from her the details of the bandits."

Things get more complicated when a game suggests multiple outcomes or even branching outcomes. In this case, consider using conditional statements—would have, could have, and so on—to express these. You may assume successful progress down the main, heroic plotline, with other possibilities branching off from this. For example, the Ward Mossfeld article has several branching possibilities: "The Kalach-Cha, after defeating the Lannon siblings, would have faced him and his brothers, Wyl and Webb. If the Kalach-Cha, Amie, and Bevil were defeated, they could have asked Merring for a rematch or submit that Mossfelds had won." However, this can sound very vague and uncertain, and is difficult to write well. If it gets too bad, consider adding a Gameplay section to the Appendix, and discuss the various outcomes there more freely.

By custom, you may refer to the players as "adventurers", as almost players are adventurers and the rest may be viewed as such. They are also usually unnamed. However, the protagonists of some games have acquired some more-or-less useful titles: Gorion's Ward for the Baldur's Gate game series, the Hero of Neverwinter for Neverwinter Nights, Drogan Droganson's Pupil for the Shadows of Undrentide and Hordes of the Underdark expansions of Neverwinter Nights, and the Kalach-Cha for Neverwinter Nights 2 and some of its expansions. These may be used where relevant, though they are not easy to follow. Finally, if the adventure module or game is written as a novel or is referred to in a sourcebook, then canon characters may have performed these events. Thus, by preference, you should refer to them where applicable. For example, Abdel Adrian was involved in events specific to the Baldur's Gate novel series and Gorion's Ward was involved in events specific to the Baldur's Gate game series, and where events are the same in both series, Abdel Adrian acted in place of Gorion's Ward. In a lesser case, the players of Cormyr: The Tearing of the Weave are described as "adventurers in service of Mystra" in The Grand History of the Realms, confirming the Tunaster Dranik opening plot hook, so this may be assumed to be the canon case, rather than one of the other alternatives.

Infoboxes
The first key part of an article is the infobox. This is a sidebar providing a summary of important information, so the reader may tell at a glance if it suits their interests or quickly find some basic lore like a character's title, a town's population, or an item's value. It also includes crunchy information like the levels of characters, magic items, and spells, allowing the wiki to present important crunch while still keeping it out of the main article.

Look through Category:Infoboxes for a suitable infobox. Most are widely applicable, and if you're not sure, check out some other articles (click edit to see the code used) or ask another user. The key ones are Person (for all non-player characters), Location (for lands, realms, and wildernesses), Building (for castles, inns, towers, shops, etc.), Spell (for all kinds of magic spells), and Item (for magic and mundane items), {{tl|Creature (for races and monsters in general), but we have others. Just copy the raw template from the page and paste it at the top of your own, then start filling out the entries.

Each template has their own separate guidelines for each entry. You don't have to use all entries; in fact, you usually can't. You may delete entries you won't use, but consider leaving some present for later users to expand on, if further lore is possible. For example, an ordinary peasant doesn't need the dynasty and reign entries used for monarchs, but may have parents, spouses, siblings, or children. A 4th- or 5th-edition character may require the 4e and 5e alignment and class entries, but usually won't need the 1e, 2e, and 3e entries, and vice versa.

To save time and effort, you can find another article on a similar topic and copy the infobox template used there, then correct the relevant entries. Editors making articles on every person in a town will often reuse their infoboxes like this. However, take care that you fully update the infobox and that you don't leave any errors behind. You also may need to add missing entries that weren't included in the other article.

A feature of every infobox is the image, to nicely illustrate the subject. The infobox allows a larger image size than the thumbnails, and this is the first thing a reader will see, so try to find an eyecatching image that best illustrates the subject. Per edition conventions, try to use the latest image if possible. If no image is suitable, say there are no canon images or there are only maps, you don't need to include an image here at all. But if you have an image, link it in the "image" entry with, where "image.jpg" is the file name and "250px" is the size of the image. On the FRW, the infobox allows a maximum image size of 250 pixels, so no image should be bigger than this. Smaller images may look bad when blown up to this size, so you may give a small size. Following the image is the caption; use this to describe what is shown in the image, especially if there are several characters or complex events. A caption is not necessary if the image is very self-explanatory.

Introduction
Begin the article with a short introduction to quickly tell the reader what it's about, to give context to the article and let them know if it's something they want to read about. Try to answer the who, what, when, where, and sometimes why of the topic. Try to interest the reader in it, but keep it short and to the point.

For example, let's look at Susztam Mar-Shinn. The first line tells us:
 * Susztam Mar-Shinn was a male drow illusionist and shadow adept. He was the Head Student of the Inverted Tower and a user of the Shadow Weave in Szith Morcane in the 14th century.

First thing, it tells us who or what the article is about, which is also the name of the article. This is bolded for emphasis (put three apostrophes on either side of the name, as in name ). This is a standard style for wikis. This should usually go first, but some topics with no proper name may require a different phrasing. If the topic has multiple names, they can also be bolded (but try to space them out a bit to make it clearer).

Second, it tells us what he is: his gender, race, classes, and occupation. You can be a bit cute with this: it's basically the beginnings of a character sheet or NPC statblock. That's fine; this is D&D after all. (We don't usually do alignment, which might be a step too far toward crunch.) For a building, say if it's an inn or castle or even both; for a settlement, say if it's a village, town, or city; and so on.

Third, it gives context, the where and when. He lives in Szith Morcane; one might go further and say it's a drow outpost in the Deep Wastes of the Underdark. He also lived in the 14th century, at least. Use your judgement on the date; drow are long-lived, so Susztam may spend much of the century in this role at the tower. In fact, he was in the post from 1354 DR to at least 1372 DR, so one could also say "mid–14th century", "mid-1300s", or "from 1354 DR onwards". Shorter lived or more transitory characters might be given a single year. Cities and nations last centuries and might not need a date. Mountains and oceans certainly don't.

Fourth, it tells us why he might be important. He's a head student at the Inverted Tower, and he's a practitioner of the Shadow Weave, which is of minor importance. Small-scale topics and short articles usually don't need any more detail. Major topics and very long articles (such as those that become Feature Articles) can have lengthier discussions of why the subject is important, even summaries of the article as a whole.

Sections
Rather than a big wall-of-text that's hard to follow, break your article up into sections, each covering a separate aspect. Each of the infobox templates and "Help:Writing an article about…" pages will present a set of example, commonly used section headings. For example, see Person and Help:Writing an article about a person. We'll use this as an example, but other types of articles work the same way.

In general, an article about a Person could have the following:

Rumors and legends
Not all are required; if a minor character's appearance is unknown, then a Description section is not needed and may be left out. (Note we say "Description" rather than "Appearance", which is a section in the Appendix; see below.) Sections may be renamed if something else is more suitable to what appears: "Relationships" to "Alliances" or "Family", for example. The order may also be changed; "History" often explains some aspect of a character or place, so it may be worthwhile putting it first, unless it may spoil a character's death, so you may feel "History" should go last. You might put "Relationships" first, to introduce the other people in the history. Think about how the article should be organized, and the story you want to tell about the topic.

Very small articles, those with only a few sentences, generally don't need sections. After all, it would look odd and unbalanced if there was more section than text on the page.

You can create a section by placing two equals signs, ==, on either side of the heading. For example, ==History==. You can make a subsection with three equals signs, such as ===Ancient history===. More equals signs produces smaller sub-subsection headings. Subsections are for breaking a large section into smaller parts focusing on individual aspects of the topic.

The custom on the Forgotten Realms Wiki is to use "sentence case" for section headings. That is, only the first word and proper nouns are capitalized in a section heading, while other words are kept in lower case. For example, "Ancient history", "Rumors and legends", "Tressym found in Cormyr", and "External links".

Out-of-universe
An out-of-universe or real-world article is one about real-world information related to the Forgotten Realms or another setting and the Dungeons & Dragons game. This includes all accepted sources of lore, i.e., sourcebooks, novels, magazines, comics, games, video games, and so on; the trilogies and series of these; and the overall ranges they are a part of. It also covers designers, writers, artists, and others responsible for their creation; the publishers who release them; and the companies who own these ranges. Assorted other topics can be treated as out-of-universe, such as pages explaining aspects of game crunch and pages covering Living Forgotten Realms and RPGA games. Appendix sections on in-universe articles are also considered as out-of-universe and should be treated the same way.

Perspective
Out-of-universe articles should of course be written from a real-world perspective—that is, your own. This should be quite easy. Just tell us about the book or whatever. Don't try to give a review or comment on events in the setting, as opinions and judgements on quality are not the point of this wiki. There are many forums and fan sites for that. While you can have some fun with in-universe articles, try to remain detached and neutral with out-of-universe articles. Remember that you're talking about the work of real people like yourself, and that not everyone will share your opinions. So, to borrow a line: just the facts, ma'am.

Nevertheless, a very detailed article on a work might necessarily discuss fan reactions and speculation, especially ones with controversial events or sitting at the break between editions. For example, the final page of The Grand History of the Realms and the Spellplague. In such a case, maintain a neutral point-of-view, and refer to those who hold the opinions discussed: e.g., "some fans thought", "many fans were worried", "reviewers said", etc. You can link to important reviews and forum discussions, especially those made around the time, to give supporting evidence. Balance opposing opinions, so a positive view is countered by a negative view, and so on. If there are many fan theories, then discuss all the main ones, not just your own pet theory.

Tense
The tense of a real-world article will vary depending on the context. As books and such are still in existence, the present tense is used to state that they are and what is presented in them. Meanwhile, past tense is used to discuss things about them that happened in the past. For example, Darkwalker on Moonshae "is the first book in the Moonshae trilogy" (present tense) but "was the first novel set in the Forgotten Realms". For another example, City of the Spider Queen "is an adventure module" and "focuses on drow, the Silence of Lolth, and the cult of Kiaransalee" (using the present tense), but it "was ranked the 24th greatest adventure of all time".

Organization
Organization is rather more straightforward for a real-world article, and shares many elements of the in-universe articles. However, they are very different according to the subject of the article.

Infobox
Again, a real-world article begins with an infobox, a sidebar providing a summary of important information about a book, game, company, or real person. For example, dates of publication, editions, number of pages, and ISBNs for books, and some basic background for an author or artist or for a company.

Look through Category:Infoboxes for a suitable infobox. The main ones here are {tl|Book}} (for all novels, comics, and sourcebooks) and Author (for all authors, artists, and designers), but there are others. Again, just copy the raw template and fill in the necessary entries. These tend to be much easier to work with. You can also include an image, usually the cover of a work or a photo of an author.

Introduction
As normal, begin the article with a short introduction to quickly tell the reader what it's about and give context to the article.

If it's an article a book, game, or comic, then put the title in bold at the start, mention the authors or designers (as well as artists if it's a comic, given their key role), and give the original publication date. Also state what series and range the work is a part of, and if it's a sourcebook, state what edition of D&D it was designed for. Consider also giving a brief summary of what it's about and any significance it has.

If it's an article for a real person, then put their name in bold, give their occupations and what they've done in the Forgotten Realms setting or Dungeon & Dragons game, and what might make them important: famous characters they write for, for example.

Sections
Real-world articles are also broken up into sections, but they have can very different sections, depending on their topic and what you choose to write about them.

An article about a source may have sections for a Summary, briefly summarizing the story or subject; a Synopsis summarizing a story in more detail; and an Index listing everything in the source that can be a subject for the wiki. An article about a person would give a brief biography and a list of works, though these don't require sections if they are too short.

Writing style

 * US English
 * Humour

Formatting and style

 * Book title (italics) vs article title (quotes)
 * Punctuation
 * Links
 * Years
 * Measurements