More languages
More actions
This guide aims to give effective and practical tips on how to write in a more encyclopedic tone. You're not strictly required to follow this guide, but may find it helpful when writing on ProleWiki.
It's by no means finished yet, and will likely be updated here and there.
What is encyclopedic tone?
Encyclopedic tone is different from how you likely normally write. Encyclopedic tone is very different from an essay or fiction tone, and often requires some getting used to—the only remedy is to write with it, and keep doing it until it becomes second nature.
Encyclopedic tone is born from a few factors. First, what makes an encyclopedic entry different from a news article, fiction, an essay, or a poem?
The answer is that materially, we are usually writing after the fact. Our job as encyclopedia writers is not to give breaking news to the readers or even judge the information, but rather to give them the facts as they chronologically happened. This is more evident when writing about historical topics: when writing on Robespierre's biography or legacy, for example, we're not publishing pamphlets to support Robespierre. We're not necessarily trying to exonerate him either. What we do when writing a page on Robespierre is saying this is what he did, this is why he did it, and this is what happened from it.
Writing with this style in mind helps our tone be consistent across our thousands of pages and never jarring to the reader. It also helps them understand what we want to convey more easily, and with less possibilities of confusion. Be mindful that this guide was not written with encyclopedic tone! Refer to the provided examples instead for examples of how to apply encyclopedic tone.
If you have to remember one thing: we write for the reader first and foremost!
Tips to achieve encyclopedic tone
In a nutshell
- Write for a global audience: Use clear, simple language for readers unfamiliar with the topic or language.
- Be objective: Present facts without judgemental words. Avoid unverified statements, there is always a way to reword a statement to make it truthful based on the available facts.
- Use concise sentences: Break down complex information into short, direct sentences.
- Limit descriptive words: Use adjectives and adverbs sparingly. Mix active and passive voices appropriately.
- Include comprehensive details: Ensure all relevant information is included for clarity, at all times. We write for a global audience.
- Use internal links: Link to related pages to avoid over-explaining and keep the focus on the main subject.
- Encyclopedias keep a historical record: when rewriting or adding onto a page, don't remove history that was already there.
Write chronologically (in the order events happened), making sure to properly place dates, names, titles and people. Don't remove history from a page; encyclopedias keep a historical record. You are however encouraged to reorder paragraphs around as pages evolve and bloat.
For example, don't write:
Then-senator Joe Biden said that ...
Instead, write:
In 1986, then-senator (and later president of the United States) Joe Biden said that ...
In the second case, we are answering the date, person (not everyone knows Joe Biden), and title. This is important context that people need to be informed and learn, which is the entire purpose of an encyclopedia.
Understanding our audience
It's important to remember who you are writing for when making an edit to a page. The people we are writing for is global: ProleWiki has been browsed from over 200 countries and territories. Every reader is unique: they may not read English as well as you do, or they may not be familiar at all with the topic you are writing about.
Clear and Purposeful Language
We don't gain points for style and form. What encyclopedias have to do is to basically spoon-feed information to the reader on the basis that:
- They may not know anything about the topic, or
- We may still be able to teach them something they didn't know about the topic.
With the understanding that we can't know where any one reader will fall between these two categories.
For this reason, we need to use clear, purposeful language. You should aim to write as concisely as possible while conveying as much meaning as possible. This means writing short sentences that detail everything. When writing, think of the questions a reader that knows absolutely nothing about the topic will ask, and answer those questions for them.
Avoiding unverified statements
Purposeful language means that you have to choose your words carefully and not say things which are not corroborated either by the facts or the sources. A somewhat common scenario is speaking too matter-of-factly, as if our version was the final one while facts are still being established. We don't convince people by telling them we are right, but by giving them the facts, no matter the page.
For example, when someone is being accused of something (let's say of embezzling funds), it is too soon for us to say they are a criminal or embezzler. Instead of saying:
Mark embezzled funds to the amount of 15,000$.
We should write:
The union accused Mark of embezzling 15,000$ from their fund.
It's important to understand what the reference you use is saying and not saying. This second sentence is more accurate and thus reduces confusion. In the first sentence, we don't know where the funds came from or whom Mark stole them from. It also implies that Mark was sued and a court found that he was guilty of embezzlement. The second sentence specifies who made the accusation and that this is not a lawsuit, with only a few words difference. If we wanted to explain that Mark was then sued in court and found guilty, we would have to add new sentences:
The union accused Mark of embezzling 15,000$ from their fund. In 2015, the case was settled in court. Mark was ordered to give back the entirety of the funds.
This may seem very basic, but several things are happening here. We are building on the original sentence that was there and adding later facts onto it in the chronological order they happened: first the embezzling happened, then the union accused Mark, then a lawsuit was filed before he could be ordered to give back the money by a court. We are giving all that information out in just three sentences.
Avoiding overloading sentences
The most common non-encyclopedic norm we see on ProleWiki is trying to fit too much information in too little space, which ends up in a jumble of adjectives and statements:
The CPUSA opposed the Korean War and Syngman Rhee's puppet government in South Korea as well as the U.S. puppet states in Taiwan Province and South Vietnam.
The "problem" in this sentence is that it's a run-on sentence, which may require a reader to read it several times to properly understand it. It also tries to fit too much information: readers who are not familiar with Rhee can click his name (provided there is a bluelink on it) to read his page, and find out he was the dictator of South Korea. The original sentence also tries to fit two different ideas in just one sentence: that CPUSA opposed one war and its government, and two other states. Rewritten with a more encyclopedic tone, it could look like this:
CPUSA opposed both Syngman Rhee's government and the broader Korean War. It also opposed the puppet states the U.S. had set up in Taiwan and South Vietnam around that same time.
Let the words breathe, and make more sentences if you need to!
Limiting adjectives and adverbs
Generally, you should limit adjectives and adverbs to a minimum. You should also mix the use of the passive and active voices when suitable. Here's an example:
In 1944, Browder briefly [adverb] dissolved the CPUSA [active voice]. Due to the intervention of the PCF, the party was reestablished and Browder was purged [passive voice].
We could instead say:
In 1944, Browder dissolved the CPUSA [active voice]. The party was reestablished through the intervention of the PCF [passive voice], and Browder was purged.
These simple changes limit confusion and reading fatigue and also save on reading time when multiplied over an entire page. However, the proposed edit above is still not entirely complete. It doesn't detail when the party was re-established, when Browder was purged and why, or what exactly the PCF did. This is something we should tell the reader directly even if there is a reference attached to the sentence.
Maintaining a factual tone
Encyclopedic tone is very factual and tries not to be (overly) judgmental. Think of yourself as writing in the name of ProleWiki, meaning you are writing as 20 different authors. While we don't have strict rules against criticism and bias, it's better to just lay down the facts as we have them and let readers make up their own mind. Of course, as the writer, you help steer the reader towards a certain conclusion—this is bias, and we acknowledge that it exists and that it's not really possible to stop it entirely. This is why unlike other wikis, we don't have zero tolerance for it.
For this, you need to understand what the reference you are using as a source for your claim is saying and not saying. You can also attribute words not to ProleWiki as a whole but to a certain author, e.g.
According to Michael Parenti, Italy has not broken with its fascist past.
Instead of:
Italy has not broken with its fascist past.
This is not mandatory but it helps the reader too.
Rely on internal links
Speaking of which, our job as encyclopedia writers is to convince the reader with our arguments and facts, and not simply because we write better or manage to say a lot with the jargon. Rely on bluelinks to help you with this: you don't always have to write the entire history of Taiwan whenever you mention it. You can just link to the Taiwan page which explains it, and go on with what you were going to write about. You should also freely make redlinks (links to pages that don't exist yet) as it lets other editors know what pages to create next.
Rewrite when necessary
Sometimes, you might need to rewrite a paragraph from scratch. Feel free to rewrite entire portions of a page when needed, or just shuffle paragraphs around if they make more sense. We've been writing pages since 2020, and over the years some have bloated into an unorganized mess.
An example that we've had just recently was the following:
Patriotic socialists initially had yet to form a political party, [because they formed one in July 2024] instead promoting the ''CPUSA 2036'' slogan...
The reason this is phrased this way was because the earlier phrasing was:
Patriotic socialists have yet to form a political party, instead promoting the ''CPUSA 2036'' slogan...
In this case, the editor didn't want to remove wording that was already there. But they very well could have, simplifying the paragraph to:
Patriotic socialists formed their first party in July 2024, but had none before that date. Prior to that, they promoted the "CPUSA 2036" slogan...
Remember: we keep a historical record of events. It is important to note that patriotic socialists (in this example) did not have a party before 2024. A mistake would be to rewrite everything as:
Patriotic socialists formed the American Communist Party in 2024.
It's important to record what they did (or didn't do) before that for posterity. This is also something we see when it comes to parties: a party's history is still part of its life, and should be preserved on its page. If the party had a mistaken line at some point in time but fixed it later, the page should not only convey that the mistaken line was fixed: it should talk about when and why the mistaken line happened.
Working the lede
In journalism and wikis, the lede (pronounced lead as in leading) is the very first paragraph of an article or a page. We use it to introduce the topic, and it's often the most difficult paragraph to write. You basically only have 3 to 5 sentences available for it, but remember one thing: you don't have to explain the entire topic in these 5 sentences, you just have to introduce it. The rest of the page is used to go deeper into the topic and go through all of it.
Stubs usually will only have a lede and no headings (as an example, the title "Working the lede" above is a heading). As a page becomes longer, the lede should be separated into different headings.
Lede bloat is a real problem, however, it might make sense on very long pages (see for example the United States page: the lede is very long, but so is the page). Don't hesitate to rewrite the lede entirely when needed and move things around under new or different headings.