Guidelines
(→Where to use links) |
|||
| (3 intermediate revisions by one user not shown) | |||
| Line 2: | Line 2: | ||
==Explaining Concepts== | ==Explaining Concepts== | ||
| − | When explaining concepts in your articles, write in a way that will be easily understood by everyone, even if they are a novice with [[UBot Studio]] and [[automation]]. Be sure to explain things in their full context. Remember that people do not necessarily know what you know, and they might not be thinking the same things you're thinking. | + | When explaining concepts in your articles, write in a way that will be easily understood by everyone, even if they are a novice with [[What you can do with UBot Studio | UBot Studio]] and [[Robots in the Workplace | automation]]. Be sure to explain things in their full context. Remember that people do not necessarily know what you know, and they might not be thinking the same things you're thinking. |
If you need to build on top of other concepts that are not explained or defined in your article, make sure the concept links to an article that provides further explanation. It is ok if the article doesn't exist yet. | If you need to build on top of other concepts that are not explained or defined in your article, make sure the concept links to an article that provides further explanation. It is ok if the article doesn't exist yet. | ||
| Line 10: | Line 10: | ||
== Where to Use Links == | == Where to Use Links == | ||
| − | Links should be made to any concept or idea (ie, [[ | + | Links should be made to any concept or idea (ie, [[Loop]]) that has a page, and any concept or idea that does not already exist as a page should have a page created. The link is only necessary the first time the word or phrase is used in the article. |
==Documenting Commands and Functions== | ==Documenting Commands and Functions== | ||
| Line 18: | Line 18: | ||
# A general summary. This will appear under the main article title. This should start out by saying which command/function group the command/function belongs to. | # A general summary. This will appear under the main article title. This should start out by saying which command/function group the command/function belongs to. | ||
# An example use of the command. Ideally, this will contain both code from the code view and an image of the visual editor. Make the examples as simple as possible while effectively demonstrating the command/function's proper use. | # An example use of the command. Ideally, this will contain both code from the code view and an image of the visual editor. Make the examples as simple as possible while effectively demonstrating the command/function's proper use. | ||
| − | # Additional Information. In this section you will put additional information that | + | # Additional Information. In this section you will put additional information that will aid in the user's understanding of the command. This could include external links, videos, or further reading materials from forums, websites, or other valid sources. |
Latest revision as of 16:03, 10 March 2014
This article will go over guidelines that should apply to every article written for this wiki.
[edit] Explaining Concepts
When explaining concepts in your articles, write in a way that will be easily understood by everyone, even if they are a novice with UBot Studio and automation. Be sure to explain things in their full context. Remember that people do not necessarily know what you know, and they might not be thinking the same things you're thinking.
If you need to build on top of other concepts that are not explained or defined in your article, make sure the concept links to an article that provides further explanation. It is ok if the article doesn't exist yet.
Write with minimalism in mind. While you need to explain ideas in their full breadth, use as few words as possible to do so. Simple and concise beats complicated and wordy.
[edit] Where to Use Links
Links should be made to any concept or idea (ie, Loop) that has a page, and any concept or idea that does not already exist as a page should have a page created. The link is only necessary the first time the word or phrase is used in the article.
[edit] Documenting Commands and Functions
All entries explaining commands or functions should contain subsections:
- A general summary. This will appear under the main article title. This should start out by saying which command/function group the command/function belongs to.
- An example use of the command. Ideally, this will contain both code from the code view and an image of the visual editor. Make the examples as simple as possible while effectively demonstrating the command/function's proper use.
- Additional Information. In this section you will put additional information that will aid in the user's understanding of the command. This could include external links, videos, or further reading materials from forums, websites, or other valid sources.
