Created: Nov 10 2024 by manavortex
Last documented update: Nov 10 2024 by manavortex
This page contains our wiki editing guidelines.
- If you would rather learn how to edit the wiki, please check .. -> #how-to-edit
The first thing you should do after clicking the "Edit in Change Request" button is to give your merge request a title. Not only will future you be grateful, nothing is more annoying than returning to something like this:
Please give your wiki page a header (see #summary). You can find a template to copy and paste under page-header-summary.md.
{% hint style="info" %} When updating a page, please adjust the "last documented update" line. (I keep forgetting myself, but it'll help people to see what is up-to-date and what isn't) {% endhint %}
You can add images into the editor by either pasting from clipboard or drag-and-dropping a file.
Unfortunately, gitbook's default name is as helpful as the NCPD customer feedback box:
They know about this, but haven't changed it yet.
Please name your images. As of November 2024, you can find the "Files" section on the left, in a tab behind the "Pages" tree:
{% hint style="info" %} The internet is full of guides on writing nonfiction. This one is good. {% endhint %}
Keep guides short and concise.
{% hint style="info" %} Remember that most of the world are not native speakers of English. Keep your sentences short and use clear language.
You can use ChatGPT or goblin.tools Formalizer (More to the point (unwaffle)) to go over your guides before posting them.
{% endhint %}
- It's easier to follow a numbered list than to read a long paragraph
- Use bold text to highlight stuff that is important.
- For anything extra, check #put-extra-info-into-expandables.
{% hint style="info" %} Your guides should be easy to read. Here's a few tips how to achieve that. {% endhint %}
You probably read the box "Your guides should be easy to read..." first. That's why I put it in a box: I wanted you to!
You can link to headings, which makes them quite useful to split up long guides into manageable content. Here's how I (manavortex) use them:
- Heading 1 marks the beginning of a section
- Heading 2 marks the beginning of a subsection within a section
- Heading 3 splits subsections into individual parts
Anything that's not immediately relevant to the guide (but too interesting to cut out) can go into an expendable box.
By the way...
Nobody likes walls of text. By this point most people know that you should have short, sweet paragraphs with line breaks between them. The shorter, the better. If you’re ever debating whether or not to end the paragraph and add a line break, err on the side of “yes”.
Once you understand this principle, you can generalize it to other aspects of your writing. For example, I stole the Last Psychiatrist’s style of section breaks – bold headers saying I., II., III., etc. Now instead of just paragraph breaks, you have two forms of break – paragraph break and section break. On some of my longest posts, including the Anti-Reactionary FAQ and Meditations on Moloch, I add a third level of break – in the first case, a supersection level in large fonts, in the latter, a subsection level with an underlined First, Second, etc. Again, if you’re ever debating more versus fewer breaks, err on the side of “more”.
Finishing a paragraph or section gives people a micro-burst of accomplishment and reward. It helps them chunk the basic insight together and remember it for later. You want people to be going – “okay, insight, good, another insight, good, another insight, good” and then eventually you can tie all of the insights together into a high-level insight. Then you can start over, until eventually at the end you tie all of the high-level insights together. It’s nice and structured and easy to work with. If they’re just following a winding stream of thought wherever it’s going, it’ll take a lot more mental work and they’ll get bored and wander off.
Remember that clickbait comes from big media corporations optimizing for easy readability, and that the epitome of clickbait is the listicle. But the insight of the listicle applies even to much more sophisticated intellectual pieces – people are much happier to read a long thing if they can be tricked into thinking it’s a series of small things.
The right image can sum up several paragraphs of writing. Make sure to use the right images.
If you include screenshots of anything, make sure to highlight the important parts (e.g. by drawing boxes and arrows). You can use Greenshot for this.