-
-
Notifications
You must be signed in to change notification settings - Fork 70
Home
Martin edited this page Oct 16, 2020
·
8 revisions
If you're familiar with Git and markdown, please follow our Contribution guide.
You can contribute to Knowledgebase with an article. DX Knowledgebase has two possible types of articles - problems (that you have encountered) and practices (the best practices to overcome problems).
- Ask for or propose an article topic via email [email protected]
- Name your article
- Write an article. Feel free to use your favorite text editor.
- Send us your article on [email protected].
- Use the active voice when possible
- Establish a clear structure and try to be precise
- Be brief, clear, and direct
- Important information in the main clause
- Simplify your language
- Avoid jargon and abbreviations
- Define acronyms and initialism on their first use - give the abbreviation in parentheses after the full terminology
- Use a grammar check tool, for example:
For Practice:
What Is a %{name}
Why You Might Want the %{name}
Problems the %{name} Helps to Solve
How to Implement the %{name}?
Common Pitfalls of the %{name}
Resources for the %{name}
For Problems:
What Is a %{name}
Reasons for %{name}
Resources for %{name}