Contributing to the CCAI Wiki

From Climate Change AI 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

The Climate Change AI Wiki is a community-driven platform summarizing state-of-the-art knowledge and resources on various topics related to machine learning applications for tackling climate change. The wiki is a place to learn about, share, and distill ideas related to climate change and AI, and we hope to grow into an accessible and comprehensive resource for the community.

This can entail many different things, currently, most importantly, an overview of application areas for machine learning, background readings, online courses and course materials, lists of conferences, libraries and tools, datasets, and relevant groups and organizations. However, this list must not be exclusive! But the CCAI Wiki is explicitly not intended to be one of the following:

  • A general online encyclopedia on content related to machine learning or climate change. There is already great free and other community content on Machine Learning and Artificial Intelligence and Climate Change at, for instance Wikipedia and other resources. We aim to explicitly address the intersection of Machine Learning and Artificial Intelligence in application areas related to climate change.
  • An advertising platform. The CCAI Wiki aims to provide useful resources for people who 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 companies. However, this is not a platform for blatant self-promotion. We welcome contributions such as links to relevant projects, survey papers, or institutions and companies, and it is appropriate if you are personally involved. However, these contributions must be provided within the appropriate context and are subject to discussion and review by the Wiki community.
  • 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 intended 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 news board. Compared to other CCAI activities, the Wiki aims to provide more long-term content. For short-lived resources, like events, job opportunities, see our Newsletter or Forum.
  • A plain link collection: Each listed item should be provided in the appropriate context and should have a sentence or two describing its context.

Community Guide Lines

Code of Conduct

The Wiki is maintained by CCAI core members and aims at building a community of moderators and editors. CCAI values an open exchange of ideas, freedom of thought and expression, and respectful science-based debate. As for other CCAI activities, this requires an environment that recognizes and respects every person's inherent dignity and worth. The CCAI community guidelines (or Code of Conduct) outline operational standards and expected behavior throughout all CCAI activities, and therefore also 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 atmosphere for productive, creative exchange by following these guidelines. Note the possibility to "'report any concerns related to your interaction at CCAI activities to reporting@climatechange.ai.'"

If a participant engages in behavior 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, please 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 Wiki is designed to support an 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 attribute ideas if sharing them elsewhere properly.

Contributing

Overview of the structure of the Wiki

Unlike Wikipedia that has no hierarchical structure, or no specific entry point, the CCAI Wiki is structured as follows:

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. 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 be able to 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. 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. 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. Or, there may be outdated content, like a preprint that is now a published paper. 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.If you notice that something worth discussing, you may also want to join one of the community activities.
  • 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 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 Creating a new Page on how to create a new page.

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 info@climatechange.ai with ‘WIKI’ in the subject line.

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#Community). 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.

Once the page is created

{{Subpage}} {{ApplicationArea}}

Once you created a page, the page should have a 1-2 sentence summary. Then a subpage should have the following structure:

  • Background Readings
  • [Optional: Online Courses and Course Materials]
  • Conferences, Journals, and Professional Organizations
  • Libraries and Tools
  • Data
  • Future Directions
  • Relevant Groups and Organizations
  • References

While a page is still a work in progress, you may want to add either of the following to:

  • A note at the beginning to make sure people don't confuse CCAI Wiki with Wikipedia: This page is part of the Climate Change AI Wiki, which aims provide resources at the intersection of climate change and machine learning.
  • For pages with missing content: 🌎 This article is a stub, and is currently under construction. You can help by adding to it!

  • For individual sections with missing content: 🌎 This section is currently a stub. You can help by adding resources, as well as 1-2 sentences of context for each resource.

These can be included as follows:

  • Import the stub template (when you’re in the visual editor, Insert > Template > search “Stub” > Insert; when you’re in the source editor, {{Stub}})
  • Import the section stub template (when you’re in the visual editor, Insert > Template > search “Stub” > Insert; when you’re in the source editor, {{SectionStub}})
  • Import the disclaimer template (when you’re in the visual editor, Insert > Template > search “Disclaimer” > Insert; when you’re in the source editor, {{Disclaimer}})

Delete a page

Reference Page

Reference page Electricity_Systems

Community

Slack Channel

CCAI Meetups

Feedback

Please visit this link and/or write to us at info@climatechange.ai with ‘WIKI’ in the subject line.

Attribution

List of CCAI Wiki Contributors