Skip to main content

Contributing

info

Thank you for your interest in contributing to our documentation site! We appreciate your support and value the insights and expertise of our community. This page outlines the guidelines and process for contributing, as well as the rewards you can earn for your efforts.

If you are seeking funding from the Conflux Foundation for your projects, please refer to our Grants page.

How to Contribute​

We welcome contributions in a variety of forms, including but not limited to:

  1. Pointing out a mistake/typo and (optionally) providing a solution
  2. Providing translation
  3. Creating or improving diagrams, charts, or visual aids
  4. Suggesting improvements to the documentation structure or organization
  5. Writing or updating a tutorial or guide
  6. Creating or updating code samples, examples, or demos
  7. Polishing or improving document writing

To make a contribution, please take one of the following actions:

Create an Issue​

You can create an issue for the following purposes:

  • To report any mistakes or typos.
  • To request new content or improvements to current content.

You can typically create an issue directly through the GitHub web page. Here, you'll find various templates to guide your issue submission.

issue templates

If you're able to address the issue yourself, we encourage you to take the initiative. When creating an issue, you can indicate your willingness to resolve it. For bug reports, select the option “I'd be willing to fix this issue myself” in the BUG template. For feature requests, select “I'd be willing to contribute this feature myself” in the Feature Request template.


// in BUG template
- [ ] I'd be willing to fix this issue myself.
// in Feature Request template
- [ ] I'd be willing to contribute this feature myself

Alternatively, you can submit your issue through the Conflux Documentation Issue Form. If your submission is approved, it will be created on the GitHub repository.

Conflux Documentation Issue Form

Create a Pull Request​

Contributing to projects through a pull request (PR) is a valuable way to improve existing documentation or code. This guide will walk you through the process step by step, ensuring clarity and ease of understanding, especially for those new to GitHub and git operations.

note

This process does not apply to TRANSLATIONS.

Minor Changes via Github Web UI​

For simple corrections or enhancements like typos or sentence improvements:

  1. Navigate to the Page:

    • Go to the English version of the page you wish to edit and click the "Edit this page" button. This button is typically found at the top or bottom of the page.
      • Edit this page

  2. Forking the Repository:

    • You'll be redirected to GitHub, where you might see a prompt saying, "You need to fork this repository to propose changes." Click "Fork this repository".
      • Fork this repository

  3. Making Edits:

    • Once in the editor mode, make the necessary changes. After editing, scroll to the bottom where you'll find the "Commit changes" section. Fill in a brief description of your changes, then click "Propose changes".

  4. Submitting the Pull Request:

    • After proposing changes, you'll be directed to a new page to initiate the pull request. Click "Create pull request". Double-check the changes and fill in any additional information if necessary, then finalize by clicking "Create pull request" again.
      • Remember to check preflight checks by adding "x".
      • preflight checks

Local Development for Substantial Changes​

tip

Refer to Github's tutorial if you are not familiar with git or Github operations.

For more significant contributions like adding a new page or extensive revisions:

  1. Setting Up:

    • Ensure you have node.js (version >= 18) and yarn installed.
    • Fork and clone the documentation repository. Detailed instructions for forking and cloning are available on GitHub's help pages.

  2. Making Changes Locally:

    • Run yarn && yarn start in your terminal to preview the site at http://localhost:3000.
    • Navigate to the docs/** folder in your cloned repository to make changes. Refresh your local server to see updates.

  3. Submitting Your Changes:

    • After making changes, run yarn build to ensure everything compiles correctly.
    • Commit your changes with a meaningful message, then push to your forked repository. Initiate a pull request on GitHub by comparing your branch to the original repository.

Working on an Existing Issue​

To avoid overlapping efforts and streamline contributions, it is suggested to follow these steps:

  1. Check for Accepted Issues:

    • Look for issues labeled "ACCEPTED" or similarly indicating readiness for contributions. If unsure, ask in the issue comments.

  2. Announce Your Intentions:

    • Comment on the issue stating that you are working on it. This helps prevent duplicate efforts.

  3. (Optional)Link Your Contributions:

    • When committing your changes, reference the issue number in your commit message, e.g., fix: typo. Ref #123456.

Provide Translation​

note

A translation pull request in the Github repo will NOT be accepted.

We are using Crowdin for document translation integration. Crowdin helps us to know whether translation strings are outdated after the source files are changed. Anyone can submit translation strings in Crowdin, and translation strings will be pushed to Github repo after they are reviewed.

Crowdin Tutorial​

Visit our project page on Crowdin at either https://crowdin.com/project/conflux or https://zh.crowdin.com/project/conflux and select the language you wish to translate.

languages

You will be able to select a file to begin translating.

files

In order to edit, you will need to be logged in. No need to fret though, you can easily log in with your Github account by clicking a few buttons.

login

Once you are in, you can start the translation process! Simply click on a source string on the left-hand panel and input the translation or edited string. Remember to click SAVE and wait for your translation to be reviewed.

translation

Once reviewed, the translation string will be pushed to the Github repository and you can visit your translation on the official documentation site.

Contributor POAPs​

After the end of each quarter, we issue a batch of Contributor POAPs (Proof of Attendance Protocol) to recognize individuals who have made contributions to our documentation site. To be eligible for minting a POAP, your contribution must meet the following "ACCEPTED" criteria:

  • Creation of an issue that has been labelled "ACCEPTED" by the repo maintainter.
  • Successful merging of a Pull Request into the main branch.
  • Full review and approval of a translation string.

POAP Contract Addresses:

These POAPs, deployable in both Core Space and eSpace, function as a unified NFT, symbolizing your valuable contribution across the Conflux network.

Special POAPs​

In addition to the regular contributor POAPs, we recognize and reward significant contributions with special POAPs. Examples of significant contributions include high-quality guides or consistent, frequent contributions to the project. The decision to award a special POAP is made on a case-by-case basis by the project maintainers.

FC (FansCoin) Rewards for POAP Holders​

As a token of appreciation, contributors can claim FansCoin (FC) rewards for each POAP they own. The amount of FC awarded varies depending on the specific POAP.

Please note that the FC reward pool is located exclusively in Core Space at cfx:achm6kb92by13rpvwd04zscn1127zuaseu25usm7sc.

Regular Review of POAP Issuing Rules​

Please note that the POAP issuing rules are subject to review and possible changes every 3 months. This ensures that our guidelines remain relevant and effective in promoting and rewarding valuable contributions.

We look forward to your contributions and thank you for helping us improve our documentation site! If you have any questions or need assistance, please feel free to create an issue in our Github repo.