Post Publishing Principles
For the sake of sustainability of effort and personal enjoyment, I have developed some working principles to guide what I shall include in posts and how I will write them.
Only what is needed to make the desired point should be present.
If the point of a post is to introduce an idea, introduce it and no more. Justifications and examples may be split from the description of an idea and posted later.
Avoid linking to anything which is not strictly necessary to understanding a post. It should be easy for a reader to understand a single post in its entirety.
Use simple language. Utilize bullet points and diagrams. Get to the point and stay on the point.
Don’t ramble: Pull stories and motivations out into their own posts. If any preamble must be given, consider linking elsewhere and summarising.
Posts shouldn’t take long to read.
Avoid covering multiple points. By focussing on single topics, posts become independent chunks that may be composed together into new documents, lists and other structures.
Large posts should be avoided. Instead, large documents should be assembled from smaller independent posts.
Publish as soon as possible. An imperfect post published is more valuable than a perfect post postponed: The imperfect one may be perfected just as quickly, but some value (instead of no value), is made available immediately.
Tags and other metadata can be applied after publishing. There is no reason to delay publishing until the correct organisational structures have been conceived of.