Contributing to these web pages

How to contribute to the Grin webpage

Ensure you have a Github account. Then:

Fork the website
- On https://github.com/mimblewimble/site, click Fork
- Once forking completes, click Settings and enable Github pages
- Verify that it works by visiting https://YOUR_GITHUB_USERNAME.github.io/site/ i.e. if your github name is grinner then replace YOUR_GITHUB_USERNAME with grinner
Edit your fork
- The lazy/easy option: just open files in your fork and click Edit, then reload the page from your github.io page as above.
- Or clone your fork locally using git, edit, then push your changes back to your fork in Github:
```
git clone https://github.com/YOUR_GITHUB_USERNAME/site
git remote add upstream https://github.com/mimblewimble/site
git fetch --all
git checkout -b my-task-branch upstream/master
(add some files, maybe with git add learn.md images/illustrative.png)
git commit -m "added illustration to learn.md"
git push --set-upstream origin my-task-branch
(then find the link that is displayed, and browse there to easily create a PR)
```
  In case you push your work in a branch other than master you will not be able to see your changes live in https://YOUR_GITHUB_USERNAME.github.io/site/. You can either merge your changes in your master branch or deploy the website locally on your host and visit http://127.0.0.1:4000.
Upstream your changes

Open a pull request with your changes.

Organizing files

Adding a new file? Follow the guidelines here

Design changes

Please come discuss design here in the design chat. It seems the logo is now finalized, at least for a while. If your suggestion needs to be shown in context, create a separate page (like example-redesignX-YOUR_USERNAME.md and push to your github.io page, then share the link on the design chat etc.

Previous examples – see here for content ideas: