Difference between revisions of "Wiki style guidelines"
Line 5: | Line 5: | ||
The Bisq wiki adheres to the Wikipedia Manual of Style whenever possible. There are some styles that Wikipedia does not cover, such as Tasks and Procedures, they will be documented in '''Exceptions''' below. <!-- Wikipedia has an extensive Manual of Styles we should leverage it whenever possible and only document exceptions. --> | The Bisq wiki adheres to the Wikipedia Manual of Style whenever possible. There are some styles that Wikipedia does not cover, such as Tasks and Procedures, they will be documented in '''Exceptions''' below. <!-- Wikipedia has an extensive Manual of Styles we should leverage it whenever possible and only document exceptions. --> | ||
− | * [https://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style <big>Manual of Style</big>] | + | * [https://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style <big>Wikipedia Manual of Style</big>] |
* | * | ||
− | * [http://en.wikipedia.org/wiki/Wikipedia:Images <big>Images</big>] | + | * [http://en.wikipedia.org/wiki/Wikipedia:Images <big>Wikipedia Images</big>] |
* | * | ||
* [http://en.wikipedia.org/wiki/Wikipedia:Cheatsheet <big>Cheatsheet</big>] | * [http://en.wikipedia.org/wiki/Wikipedia:Cheatsheet <big>Cheatsheet</big>] |
Revision as of 02:09, 24 March 2020
Contents
General guidelines
The Bisq wiki adheres to the Wikipedia Manual of Style whenever possible. There are some styles that Wikipedia does not cover, such as Tasks and Procedures, they will be documented in Exceptions below.
Exceptions
Non English language articles
Until there is a need for separate language wikis, create articles in the non English language with the English translation in comments. See Running Bisq in China as an example.
Procedures
The Bisq wiki contains many procedures. The Wikipedia Manual of Styles does not include styles for technical tasks and procedures. The Microsoft style guide for procedures and instructions has excellent guidance [Procedures and Instructions].
Tabs, buttons and UI elements
User interface (UI) elements such as tabs and buttons are indicated in bold text. When referring to an action, simply state "click Start", not "click the Start button"