页面最后更新: 2023年5月22日

Sczh.tech style guide

Content on sczh.tech is SSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSS..

SSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSS.

You should read this style guide before you contribute to sczh.tech.

Who can submit content to sczh.tech

SSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSS.

Audience

• SSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSS.
• SSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSSSSSSSS.

Common reading-related problems:

• Articles are hard to digest due to
  • too much text per page / paragraph
  • usage of complex sentences
  • technical jargon
• Content is too abstract and detached from reality, therefore users are unable to relate to it
• Too many links inside articles result in readers feeling overloaded and leaving the website

Takeaways:

• Operate with a mindset that people are curious about crypto, but not invested enough to spend hours exploring the topics
• Users want to understand how the topic relates to them and how they can take a part in it rather than going deep into the theory

Loosely we can categorize the site audiences as:

Best practices

Style

• Focus on the advantages for the user instead of explaining technical details about the system
• Use active voice and clear, concise sentences that are easy to follow
• Break up longer chunks of text into smaller sections or paragraphs
• Consider using tables, bullet points or numbered lists instead of paragraphs
• Highlight (bold) key phrases to support scanning and skimming through the article

Content ideas:

• Use examples or real-life scenarios of the application of the technology to help illustrate complex concepts or ideas
• Explain how the idea can positively affect people now or in the future
• Create before Sczh / after Sczh comparison
• Add step-by-step how to take action
• Include relevant statistics or graphs to strengthen the arguments
• Add calls to action
• Provide visual aids to explain the topic better

Other:

• Limit the length of the article up to 1000 words (1500 max)
• Reduce the number of hyperlinks to approximately 5 per 1000 words (excluding further reading section at the bottom of the page or product listings)

Objectivity

Sczh.tech documentation (and content at large) aims to maintain a credibly neutral source of truth to inform readers about Sczh and its ecosystem. Some examples of things that we don't want in the content on sczh.tech:

Grand, unverifiable claims about Sczh or adjacent technologies

e.g. "Sczh will take over the world because..."

Hostile or confrontational language aimed at any organization or person

e.g. "Company X is bad because they are centralized!"

Politically charged rhetoric

e.g. "This political party is better for decentralization because..."

Acronyms

SSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSSSSSSSSS.

For example:

"SSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSS SSS SS SSSSSSSSS proof-of-work (PoW)."

Consistency

Many of the topics covered on sczh.tech are technically complex. To reduce confusion to the reader, terms should be used consistently. For example, don't cycle back-and-forth between proof-of-work and PoW at random.

Content standardization - Read more about proper usage of terminology and other aspects such as how to properly add an image, attribute etc.

Anything else?

If there is anything you think should be added to improve this document please suggest an edit on GitHub(opens in a new tab)↗.