The wiki was started and is maintained by community contributors and product team leads. It is an open source project and aims to be the most extensive resource of knowledge on Elastos and the Elastos ecosystem. The majority of material currently focuses on Elastos directly but it is not opposed to including informational material for community projects and initiatives.
Please do not try to pull request any marketing material as this will be rejected.
Nonetheless, pull requests, discussions, and contributions from the community are encouraged. Active community members who demonstrate a record of good contributions may be given write access to the repository.
Otherwise, product leads hold the administrative position and final say on the content that is included.
How to Contribute
You can contribute to the wiki on the elastos/Elastos.Wiki GitHub repository. Every page is a MarkDown file, which is an easy to learn syntax extension to plain text that makes creating links, rendering images, and nice-looking formatting simple.
Elastos uses Docusaurus for documentation. Please refer to their documentation for details on major structural contributions to the documentation.
For simple content changes you have 2 options
The instant PR
This is the fastest way to submit content changes directly from the page where you notice a mistake.
- Open any page in the docs
- Click the
[ Edit ]button at the bottom left hand side of every content page
- Make your edits to the document that opens in GitHub by clicking the ✎ (pencil) icon
- Submit a PR with your changes and comments for context
The typical PR
This is the standard fork-branch-commit workflow for submitting pull requests to open source repositories
Fork this repo to your own GitHub account (or just clone it directly if you are currently a member of Elastos)
Open your editor to the top level repo folder to view the directory structure as seen below
Move into the
/websitefolder where you will run the following commands:
Make sure all the dependencies for the website are installed:
# Install dependencies
Run the local docs development server
# Start the site
# Website with live reload is started
LiveReload server started on port 35729
Docusaurus server started on port 3000
The website for docs will open your browser locally to port
Make changes to the docs
Observe those changes reflected in the local docs
Submit a pull request with your changes
Guideline and Rules for Contributing
There are a few basic ground-rules for contributors:
--forcepushes or modifying the Git history in any way.
- 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. Suggestions and requests are encouraged.
- Only use non-master branches.
- Significant modifications, even by contributors, ought to be subject to a pull request to solicit feedback from other contributors.
- Pull requests to solicit feedback are encouraged for any other non-trivial contribution but left to the discretion of the contributor.
- Contributors should attempt to adhere to the prevailing
MarkDownstyle, language, and layout.
- Correct grammar should be used at all times. Pull requests with typos will not be merged until fixed.
- Care should be taken to remain as objective and informative as possible. There should be no editorializing, and external bias should not be present.
This document is based on the Level contribution guidelines.
Helping With Translations
Currently the Wiki is being populated and updated, during this time we will not be prioritizing translations.
The Wiki's default language is English, though, there is a desire to translate the Wiki in as many languages as possible. Another way you can contribute is by helping with translations.
Translation contributions can be made through crowdin. There, you will see the progress of translating the docs associated with the Wiki in many different languages.