Contributing to the CCAI Wiki: Difference between revisions

→‎Contributing: minor wording changes
m (→‎Community Guide Lines: minor wording changes)
(→‎Contributing: minor wording changes)
Line 32:
=== Overview of the structure of the Wiki ===
 
Unlike Wikipedia, thatwhich has no hierarchical structure, or no specific entry point, the CCAI Wiki is structured as follows:
* '''[[Welcome_to_the_Climate_Change_AI_Wiki|CCAI Wiki Welcome Page]]:''' This is the entry point to the CCAI Wiki. It gives an overview of the general structure of the Wiki.
* '''[[Welcome_to_the_Climate_Change_AI_Wiki#Topics_by_Application_Area|Application Areas]] and other top-level pages:''' The top-level pages are on the one hand (a) the [[Welcome_to_the_Climate_Change_AI_Wiki#Topics_by_Application_Area|Application Areas]], i.e., areas where machine learning can address climate change, thenand also (b) the [[Welcome_to_the_Climate_Change_AI_Wiki#Topics_by_Cross-cutting_Theme|cross-cutting schemes]], i.e., re-occuringrecurring topics that are part of several applications areas, and (c) the [[General_Resources|general resosourcesresources page]].
* '''Subpages:''' Each of these top-level pages may have several subpages. Note that this mustneed not be strictly hierarchical, as subpages may be cross-cutting schemes (e.g., [[Surrogate_modeling|Surrogate modeling]] is a subpage of [[Buildings_and_Cities|Buildings and Cities]]) or may occur on several pages (e.g., several pages are subpages of both [[Transportation]] and [[Buildings_and_Cities|Buildings and Cities]]).
 
=== How you can contribute ===
 
There are many different ways in that you can contribute:
* '''Share resources:''': You knowKnow a great resource that is missing? Then youYou expand a page by adding resources or references, or enhance the quality of existing resources. For example, do add relevant journals or conferences that you notice are not currently listed. When adding a resource, make sure to add a link and a brief description. This will ensure that readers will get an overview of many resources at a glance but can easily seek out further details if they find the description interesting. When adding a resource, make sure to maintain consistency in formatting. For example, if you notice that all previously added resources were in boldface font, make sure to stick to that.
* '''Improve content and clarity:''': Community wikis become more refined through many small changes contributed by many people. Do not hesitate to add a new piece of information or suggest a rewording that improves clarity. For example, if you notice that an idea is touched upon but not fully developed, a sentence or two of additional elaboration can improve the richness of the Wiki’s content. But youYou can also harmonize formatting or fix spelling and grammar issues. Or, there may be outdated content, like a preprint that is now a published paper, that you may want to update. Further, some content may not be out of scope for the Wiki (e.g., not at the intersection of climate change and artificial intelligence), and may need to be removed. Or if the content is too verbose, feel free to shorten text, remove resources, or add concrete examples to improve focus. If you notice something worth discussing, you may also want to join one of the [[Contributing_to_the_CCAI_Wiki#Community|community activities]].
* '''Identify and develop application areas:''': The current structure of the Wiki is based on the [https://arxiv.org/abs/1906.05433 Tackling Climate Change with Machine Learning] review paper. However, this field is moving fast, and there may be gaps and topics that are missing. Expand the Wiki by creating new pages on application areas, subpages within an application area, cross-cutting schemes, or other cross-sectional topics. For instance, within a general problem domain (e.g., electricity systems), there are often a few more specific subproblems of interest (e.g., supply and demand forecasting). These are typically linked from "Machine Learning Application Areas" sections on individual pages across the Wiki. We invite you to both add new application areas and develop the associated pages. See [[Contributing_to_the_CCAI_Wiki#Creating_a_new_Page|Creating a newNew Page]] on how to create a new page.
 
Don't worry about making mistakes. The CCAI wikiWiki uses an established Wiki software that saves the past versions of the page. Therefore mistakes can easily be corrected. If you have trouble correcting a mistake, reach out to [http://mailto:info@climatechange.ai info@climatechange.ai] with ‘WIKI’ in the subject line.
 
=== Creating an account ===
Line 69:
=== Moderating ===
 
==== BecommingBecoming a Moderator ====
Moderators are trusted individuals, known experts in the field, friends of CCAI, or generally contributors with a good editing track record. Moderators can join discussions in our Slack Channel (see [[Contributing_to_the_CCAI_Wiki#Community|Community]]). As a moderator, you can be listed on the [[List_of_CCAI_Wiki_Contributors|List of CCAI Wiki Contributors]]. Do you want to be a moderator, and are you researching or working in the field of the intersection of machine learning and climate change, or are you just generally interested and motivated? Then sign up here as a moderator, and we will invite you to our Slack channel.
 
==== Approving Changes ====
Moderators have the final authority on all decisions about content on the Wiki. For that, moderators can see the latest changes to a page via "View history" at the top of the page. This Review History page provides a tool to compare different edits by selecting two versions in the history (using the round tick boxes) and click "Compare selected revisions" to get a line-by-line comparison of the versions.
 
ModeratosModerators can then accept the edit by clicking ''approve'' or revert the changes by clicking ''undo''.
 
To see all the recent changes that happened in the Wiki, you may view the [[Special:RecentChanges|Recent Changes page]].