Contributing to the CCAI Wiki

This page provides information and resources needed to comprehend, comment on, and edit the Climate Change AI Wiki.

The purpose of the CCAI Wiki
What the CCAI Wiki is not:
 * A general online encyclopedia on content related to machine learning or climate change. There is already great community content on Machine Learning and Artificial Intelligence, as well as on Climate Change at Wikipedia and other resources.
 * An advertising platform. CCAI aims at providing resources that are useful for people that want to do research or work at the intersection of Machine Learning and Climate Change. In this role, we want to provide links to relevant working groups, research institutes, and also companies in this field. However, this is not a platform to promote individual products, people, application papers, and preprints.
 * A soapbox: The Wiki further is not meant to be a platform for advocacy, propaganda, or recruitment of any kind, or meant to host opinion pieces, position papers, or comments. The wiki is meant to be written from a neutral point of view. Topics around both climate change and machine learning may be controversial. The CCAI wiki aims to only briefly note or summarize such discussions and point to more readings on the topics.
 * A tool for self-promotion. While we aim to provide valuable resources at the intersection of climate change and machine learning, and also welcome contributions such as links to relevant projects, survey papers, or institutions and companies that you are personally involved in. However, these must be provided within context.
 * A news board. The CCAI Wiki aims as providing more long-term content. For short-lived resources, like events, job opportunities see our Newsletter or Forum.
 * A Link collection: Every entry that is listed should have a sentence or two describing its context.

Code of Conduct
The Wiki is maintained by CCAI core members and aims at building a community around that. CCAI values the ideals of open exchange of ideas, the freedom of thought and expression, and respectful science based debate. As for other CCAI activities, this requires a community and an environment that recognizes and respects the inherent dignity and worth of every person. The CCAI community guidelines (or Code of Conduct) outline operational standards and expected behaviour throughout all CCAI activities, and therefore apply for the CCAI Wiki.

Please read the rules regarding responsibilities & expected behavior. Most importantly, CCAI is dedicated to fostering an environment free from harassment, bullying, discrimination, and retaliation. Volunteers and community members alike should help cultivate an environment for productive, creative exchange by following these guidelines. Note the possibility to report any concerns related to your interaction at CCAI activities to [mailto:reporting@climatechange.ai reporting@climatechange.ai].

If a participant engages in behaviour that violates these community guidelines, CCAI retains the right to take any action deemed appropriate. In the context of this Wiki, this may lead to including but not limited to formal or informal private warnings, blocking of the user account, but also barring from future CCAI activities and exclusion from future CCAI opportunities and affiliated roles.

Guiding Principles
Generally, the wiki is a place that cultivates the following guiding principles:
 * Intellectual Diversity and Humility: The wiki facilitates exchange between people with different backgrounds and areas of expertise. Please keep contributions focused on ideas and content relevant to the CCAI mission, and treat others with respect in all interactions. When editing pages, remember that others might not share your jargon, may be unfamiliar with what you think is common knowledge, and may not speak English as a first language. Be professional: don’t make brash claims, do your homework, and avoid making unnecessary demands on others’ time.
 * Constructive Discussion: Contribute content that can support learning, solutions, and progress that could have real world impact. Strive to develop pages that advance the discourse on climate change and AI. To that end, don’t use this wiki as a political soapbox, for example, but do try to identify actionable ideas or great work and make them visible to the community.
 * Scientific Integrity: The wik is designed to support open exchange of ideas, and everything will be publicly visible on the web. Don’t misrepresent your or others’ work, provide evidence to support all claims, and be sure to properly attribute ideas if sharing them elsewhere.

Overview of the structure of the Wiki
Unlike Wikipedia that has no hierarchical structure, or no specific entry point, the CCAI Wiki is structure as follows:
 * CCAI Wiki Welcome Page: This is the entry point to the CCAI Wiki. It gives an overview of the general structure of the Wiki.
 * Application Areas and other top-level pages: The top-level pages are on the one hand the Application Areas, i.e., areas where machine learning can address climate change, then the cross-cutting schemes, i.e., re-occuring topics that are part of several applications areas and the general resosources page.
 * Subpages: Each of these pages may have a number of sub-pages. Note, that this must not be strictly hierarchical, as subpages may be cross-cutting schemes (e.g., Surrogate modeling is a subpage of Buildings_and_Cities or may occur on several pages (e.g., several pages are subpages of both Transportation and Buildings_and_Cities).

How you can contribute
There are many different ways in that you can contribute:
 * Share resources: You know a great resource that is missing? Then you expand a page by adding resources or references, or enhance the quality of existing resources.
 * Improve content and clarity: There may be outdated content, like a preprint that is now a published paper. 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. 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 you can also harmonize formatting, or fix spelling and grammar issues.
 * Improve focus Further, content may not be at the intersection of climate change and artificial intelligence. Or if content is to verbose, shorten text, remove resources or add concrete examples to improve focus.
 * Identify and develop application areas: The current structure of the Wiki is based on the 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 topics that are missing so far. 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. When creating a new application area page, consider adding the following sections,
 * Relevant readings: What books or papers would you recommend that someone new to the field read, to become oriented in the topic?
 * (Online) Course materials: Are there existing structured learning programs for learning about the application area?
 * Community: What societies, journals, or conferences should a new contributor to the application area become familiar with?
 * Libraries and Tools: Are there software packages that can facilitate work in this application area?
 * Data: Are there common types of data that are used in this application area? Are there example sources that are publicly available?
 * Future directions: What are the open problems in this area?

Don't worry about making mistakes. The CCAI wiki 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 XXX.

Creating an account
You can simply click on "Create account" in the upper right or go directly to the account creation page. Then choose a user name and set a password. We highly recommend choosing a secure and unique password that you are not using on any other website.

Note, that your username will be public, as well as any activities by the user. If you don't want to be associated to your real name, then you should choose an anonymous username. If you use your real name as your username, your real name will not be private and will not be able to be made private later. You may however choose to add more information about your user on the attribution page.

Editing
Everybody can edit the CCAI wiki -- even without creating an account. However, edits approved by moderators are visible on the page. Generally, there are two ways to edit a page: The visual WYSIWYG editor and Wiki markup.


 * Visual WYSIWYG Editor: A WYSIWYG (What you see, is what you get) editor allows you to visually edit the content, similar to typical word processors. As we use the same system like Wikipedia, you can also see this introduction to the visual editor.
 * Wiki Markup: Wiki Markup is a markup language similar to Markdown, LaTeX or HTML, where a special syntax controls the formatting of the text. The menu bar gives you some short-cuts, but you may also see this introduction to Wiki Markup.

Moderating
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). As a moderator, you can be listed on the list of contributors. Are you researching or working in the field of the intersection of machine learning and climate change, sign up here as a moderator and we invite you to our Slack channel.

Moderators have final authority on all decisions about content on the wiki. They are all volunteers and work hard to apply the community guidelines consistently. Please help foster a positive environment by flagging pages or edits that violate these guidelines. Don’t engage those with problematic behavior – just flag the offending material. Moderators will warn users who engage in behavior violating these guidelines, but failure to heed several warnings will result in the users being blocked from the wiki. You may appeal a moderator decision by posting a request to unblock on your User Talk page. All appeals will be reviewed, but moderators hold no obligation to reply.

Creating a new Page
There are generally three methods to create a new page:
 * Searching: Enter the name of a page in the search field. If the page for the text you entered does not already exist the search result page will allow you to create a new page.
 * Creating an internal link: When you edit an existing page and create a link to a non-existing page using the doubled brackets, e.g., Proposed Title, you can create the page by following the link. This can also happen on accident, e.g. by a typo or inconsistent spelling. If it happened by accident, see how to delete a page below.
 * Changing a URL: You can simple change the last part in the URL of the CCAI Wiki (e.g., Electricity_Systems in the url https://wiki.climatechange.ai/wiki/Electricity_Systems) to create a new page.

Reference Page
Reference page Electricity_Systems