Difference between revisions of "Contribute"
(categorized) |
(Added section w/ links to orphans/dead-ends/missing page lists) |
||
| Line 1: | Line 1: | ||
Contributing to this wiki is a big help to the Screeps community, especially the newer players. The intent of the wiki is to compliment the API and existing documentation, not duplicate the information. The details in here should lean towards concepts and ideas, instead of a hard "what" of each entity. Explanations of various implementations and uses of objects should give multiple options, and weigh the pros and cons of each. |
Contributing to this wiki is a big help to the Screeps community, especially the newer players. The intent of the wiki is to compliment the API and existing documentation, not duplicate the information. The details in here should lean towards concepts and ideas, instead of a hard "what" of each entity. Explanations of various implementations and uses of objects should give multiple options, and weigh the pros and cons of each. |
||
| − | |||
| − | |||
== Rules == |
== Rules == |
||
| − | |||
| − | |||
| − | |||
* As with any other wiki, the goal is to solely state facts. If you identify any opinions, either blunt or veiled, bring them up to the community in the #wiki channel in our community's slack. |
* As with any other wiki, the goal is to solely state facts. If you identify any opinions, either blunt or veiled, bring them up to the community in the #wiki channel in our community's slack. |
||
| Line 20: | Line 15: | ||
== High-level Concept Articles == |
== High-level Concept Articles == |
||
| ⚫ | High level concepts, like [[Operating System]] design or [[Source Keeper Mining]] are concepts that lean heavily on a full understanding of multiple smaller concepts. An explanation of what the concept is and similarities common in most implementations can be had in an overview section, then dive into more detailed concepts, linking to other articles for each if they are large enough to justify it. If a concept is important enough, but not worthy of its own article, you may create a link, redirecting to that section, so users can access it in the URL as if it were an article (e.g. "StructureWall" redirecting to "Defensive_Structures#wall"). Under no circumstances should raw code be posted in text or picture form, unless there is no way to explain the concept otherwise. |
||
| − | |||
| − | |||
| ⚫ | High level concepts, like [[Operating System]] design or [[Source Keeper Mining]] are concepts that lean heavily on a full understanding of multiple smaller concepts. An explanation of what the concept is and similarities common in most implementations can be had in an overview section, then dive into more detailed concepts, linking to other articles for each if they are large enough to justify it. If a concept is important enough, but not worthy of its own article, you may create a link, redirecting to that section, so users can access it in the URL as if it were an article (e.g. "StructureWall" redirecting to "Defensive_Structures#wall"). Under no circumstances should raw code be posted in text or picture form, unless there is no way to explain the concept otherwise. |
||
| − | |||
| − | |||
== Other Concept Articles == |
== Other Concept Articles == |
||
| ⚫ | Other concepts are not as grandiose as high-level concepts, but should be treated similarly. If there are multiple implementations, discuss each including pros and cons. Concepts can be included in game object articles such as "healing with towers" being a subsection of "StructureTower". This occurs when there is simply not enough content to justify a new article. |
||
| − | |||
| − | |||
| ⚫ | Other concepts are not as grandiose as high-level concepts, but should be treated similarly. If there are multiple implementations, discuss each including pros and cons. Concepts can be included in game object articles such as "healing with towers" being a subsection of "StructureTower". This occurs when there is simply not enough content to justify a new article. |
||
| − | |||
| − | |||
== Game Object Articles == |
== Game Object Articles == |
||
| ⚫ | Not every in-game class or object needs its own article. The example above in the rules is the perfect example: the classes "StructureWall" and "StructureRampart" both fit in the article "Defensive Structures." If a structure is important enough to warrant its own article, start with a basic overview, then roll into common (and perhaps uncommon) uses for it, different implementations of the uses (if applicable) and the pros and cons for everything. Discussions of tactics for towers (heal vs attack for defense), or common placement of links, and how to implement them is the important part. External links to the API or developers' documentation pages are acceptable. If there are any changes, an external link to the blog announcement may be warranted. |
||
| + | == Things that are missing == |
||
| − | |||
| + | As with any community wiki, we have [[Special:LonelyPages|orphaned articles]] that aren't linked to from elsewhere, [[Special:DeadendPages|dead-end articles]] that don't link to other articles, and [[Special:WantedPages|uncreated articles]] that are linked to from existing articles (these are the red links you might see around the place). These are all great places to start if you want to make a quick improvement to the wiki! |
||
| − | |||
| ⚫ | Not every in-game class or object needs its own article. The example above in the rules is the perfect example: the classes "StructureWall" and "StructureRampart" both fit in the article "Defensive Structures." If a structure is important enough to warrant its own article, start with a basic overview, then roll into common (and perhaps uncommon) uses for it, different implementations of the uses (if applicable) and the pros and cons for everything. Discussions of tactics for towers (heal vs attack for defense), or common placement of links, and how to implement them is the important part. External links to the API or developers' documentation pages are acceptable. If there are any changes, an external link to the blog announcement may be warranted. |
||
[[Category:Community]] |
[[Category:Community]] |
||
[[Category:Wiki]] |
[[Category:Wiki]] |
||
Revision as of 02:12, 3 November 2020
Contributing to this wiki is a big help to the Screeps community, especially the newer players. The intent of the wiki is to compliment the API and existing documentation, not duplicate the information. The details in here should lean towards concepts and ideas, instead of a hard "what" of each entity. Explanations of various implementations and uses of objects should give multiple options, and weigh the pros and cons of each.
Rules
- As with any other wiki, the goal is to solely state facts. If you identify any opinions, either blunt or veiled, bring them up to the community in the #wiki channel in our community's slack.
- If information is provided elsewhere, a cursory description/explanation and a link to the original source will suffice.
- Do not provide a detailed explanation of anything that is already well explained in the API page or Documentation. Provide a cursory overview, and a link to the existing location.
- Do not provide raw code in text form under any circumstances. Pictures of example code will only be used when there is no way to explain a concept succinctly without it. Solicit for advice from the community in #wiki before posting any code.
- Some in-game objects are not worthy of getting their own page. For example, the classes "StructureWall" and "StructureRampart" both fit in the article "Defensive Structures," which would briefly explain the differences between the two, then go into concepts and usages applicable to both.
High-level Concept Articles
High level concepts, like Operating System design or Source Keeper Mining are concepts that lean heavily on a full understanding of multiple smaller concepts. An explanation of what the concept is and similarities common in most implementations can be had in an overview section, then dive into more detailed concepts, linking to other articles for each if they are large enough to justify it. If a concept is important enough, but not worthy of its own article, you may create a link, redirecting to that section, so users can access it in the URL as if it were an article (e.g. "StructureWall" redirecting to "Defensive_Structures#wall"). Under no circumstances should raw code be posted in text or picture form, unless there is no way to explain the concept otherwise.
Other Concept Articles
Other concepts are not as grandiose as high-level concepts, but should be treated similarly. If there are multiple implementations, discuss each including pros and cons. Concepts can be included in game object articles such as "healing with towers" being a subsection of "StructureTower". This occurs when there is simply not enough content to justify a new article.
Game Object Articles
Not every in-game class or object needs its own article. The example above in the rules is the perfect example: the classes "StructureWall" and "StructureRampart" both fit in the article "Defensive Structures." If a structure is important enough to warrant its own article, start with a basic overview, then roll into common (and perhaps uncommon) uses for it, different implementations of the uses (if applicable) and the pros and cons for everything. Discussions of tactics for towers (heal vs attack for defense), or common placement of links, and how to implement them is the important part. External links to the API or developers' documentation pages are acceptable. If there are any changes, an external link to the blog announcement may be warranted.
Things that are missing
As with any community wiki, we have orphaned articles that aren't linked to from elsewhere, dead-end articles that don't link to other articles, and uncreated articles that are linked to from existing articles (these are the red links you might see around the place). These are all great places to start if you want to make a quick improvement to the wiki!