# Contributing

The wiki was started and is maintained by the Acala Foundation. It is an Open-ish open source project and aims to be the most extensive resource of knowledge on Acala and the Acala ecosystem. A large part of the material currently focuses on Acala directly but it is not opposed to cover informational material for community projects. But please do not try to pull request any marketing material as this will be rejected.

Pull requests, discussions and contributions from the community are encouraged. For certain active community members who demonstrate a record of good contributions, they may be given write access to the repository. Otherwise, the Acala Foundation holds the administrative position and final say on the content that is included. Specifically the Technical Education team at the foundation are most directly involved.

### How to Contribute

Contributing to the wiki is easy with a GitHub account. Every page is a markdown file, which is a [very easy to learn](https://guides.github.com/features/mastering-markdown/) syntax extension to plain text that makes creating links, rendering images, and nice-looking formatting simple.

Each page has an "Edit on Github" button on the top right of the content. By clicking this button you are taken to the GitHub sign in page, where you can either login or create an account.

![](/files/-MBi2LeHq0_wPFlZycDE)

Once logged in, you'll be taken to the GitHub text editor in which you can make your edits directly. When you've completed your changes, you can add any specific details on what was changed and commit to a new branch to create a new Pull Request to the repository. From there one of the maintainers will either merge it in or request changes very soon.

![](/files/-MBi25tghUzCXKArSDmY)

### Rules

There are a few basic ground-rules for contributors:

1. **No `--force` pushes** or modifying the Git history in any way.
2. Pull requests are preferred to issues, especially for small changes such as typos. Issues should be used for generic or broad-based changes or missing content.
3. **Non-master branches** ought to be used for ongoing work.
4. **Significant modifications** ought to be subject to a **pull request** to solicit feedback from other contributors.
5. Pull requests to solicit feedback are *encouraged* for any other non-trivial contribution but left to the discretion of the contributor.
6. Contributors should attempt to adhere to the prevailing Markdown style, language, and layout.
7. Correct grammar should be used at all times. Pull requests with typos will not be merged until fixed.
8. Care should be taken to remain as objective and informative as possible. There should be no editorializing, and external bias should not be present.

### Changes to this arrangement

This document may also be subject to pull requests or changes by contributors where you believe you have something valuable to add or change.

### Heritage

This document was based on the Level contribution guidelines located here: <https://github.com/Level/community/blob/master/CONTRIBUTING.md>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.acala.network/misc/contributing.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.