Golden is on a mission to map and generate human knowledge in order to accelerate discovery and education. This is a writing guide for contributing on Golden.
All articles on Golden should accurately report facts and information about a topic in the most informative manner possible while maintaining a neutral tone. Avoid stating personal opinions, controversial or contested assertions, or unproven assertions as facts. Use an impartial tone which does not seek to pass judgement on the subject or to take sides or a viewpoint.
Give the most balanced and nuanced perspective based on the main consensus viewpoint of experts and scholars in the field as well as any well supported opposing arguments. Avoid giving extremely fringe or conspiracy a false equivalency by giving them undue weight in an article.
Marketing language does not belong on Golden. This is especially important for descriptions of companies, products, or anything which users have a financial stake in. Contributors should generally avoid language like “best”, “most efficient”, “easy to use“, etc as these are almost always qualitative and uninformative to the user. Descriptions like “first”, “fastest”, “cheapest”, should be avoided unless a citation which directly supports the language used is supplied.
Citations on Golden provide evidence and support for claims made on Golden. Any claim which could be challenged or is controversial should be cited. The primary metric by which controversial or challenged claims will be judged is based on the quality and content of cited sources. High quality sources include scholarly papers in academic journals or news articles from reputable sources which undergo rigorous review. More niche or less well known sources can also provide important information but should be analyzed with a more skeptical eye before use. Primary source information, such as information about a company from their own blog or from a contributor who has personal experience with the topic is also ok to use, however it should be identified as primary source and used sparingly or in concert with third party sources when possible. Citations also provide a valuable source for further reading.
Even articles which start out with little information can improve over time and become high quality articles. However, articles should still strive for equal weight. Unbalanced topics which give undue weight to niche or fringe aspects of a topic may give readers an unrealistic perception of the consensus viewpoint. While articles may initially be fragmented when in early stages, over time it is important for articles to morph into comprehensive articles which give proper weight to all aspects and viewpoints of the article according to their importance. Information builds on itself and knowledge generation takes effort and time.
Avoid phrasing that will go out of date quickly like “recently” or “just launched”, “working on”. For example, replace “Biotech Company recently developed a new technology for x-ray crystallography” with “Biotech Company developed a new technology for x-ray crystallography in 2018”. Phrasing that goes out of date quickly can often be replaced by more permanent statements tethered to specific points in time. Adopting this writing style avoids unnecessary editing upkeep from the community.
Golden public topics text are open under Creative Commons 4.0 BY-SA license with some additional terms applied, so text from similarly licensed sources can be copied as long as there is attribution through a citation or further reading. However, direct copying is discouraged. Pages that are a direct copy of another page don’t provide additional value to the Internet. Contributors should strive to use their skills and expertise to improve on, or supplement, any specific source with additional information or sources rather than just copying. There are valid use cases for repurposing creative commons licensed sources but ideally this will be optimized around the best way of explaining a topic.
Always remember that other contributors are using Golden because they also want to share information and knowledge with the world and that we’re all working towards an important shared mission. Constructive and friendly communication when editing will help other contributors understand why you made the changes you did. For example, deleting or reverting incorrect information from the site is a valuable service to the community. However, without a thorough explanation of why the edit was made, other contributors may not understand why the edit was made. This will help avoid unnecessary editing back and forth or other miscommunications. Focus on constructive feedback and education of other contributors towards the policies.
Inevitably, exceptions to these rules will arise (capitalization: “eBay”, “uPort”). Contributors should deviate from these conventions when necessary in order to improve Golden’s map of human knowledge.
Abbreviations are shortened or contracted forms of words. They are useful for shortening the length of long or cumbersome phrases. However, excessive abbreviations can confuse or interrupt the flow of reading without proper usage.
Always use the full phrase along with the abbreviation in the first instance of the phrase in an article. Do not invent your own abbreviations or use abbreviations not already in common usage. Unless unavoidable, saving space by using a rare or niche abbreviation is usually offset by the time wasted for the reader to locate the meaning of the abbreviation.
In the main prose, generally use the present tense unless the subject of the article is deceased, an event in the past, or an entity that no longer exists. In timelines, typically use the present tense. Example: “AlphaGo Zero defeats the previous chess champion AI Stockfish 8” is preferred to “AlphaGo Zero defeated the previous chess champion AI Stockfish 8”.
Punctuation on Golden should follow standard English grammar rules (multi language support will be coming in the future). Make sure to conclude all sentences with periods including the abstract of all articles. Do not use exclamation marks unless directly quoting from a source that uses exclamation points.
Anything we should change? Let us know at [email protected]