1.4 KiB
1.4 KiB
Contribute
Follow these steps to contribute to this book!
We use an utility tool called mdBook to create online books from Markdown files.
Before You Start
- Install mdBook from here.
- Clone the repository by
git clone https://github.com/status-im/nim-beacon-chain.git
. - Go to where the Markdown files are located by
cd docs
.
Real-Time Update and Preview Changes
- Run
mdbook serve
in the terminal. - Preview the book at http://localhost:3000.
Build and Deploy
The first step is to submit a pull request to the devel branch. Then, after it is merged, do the following under our main repository:
cd nim-beacon-chain
git checkout devel
git pull
make update
(This is to update the submodules to the latest version)make publish-book
Trouble Shooting
If you see file conflicts in the pull request, this may due to that you have created your new branch from an old version of the devel
branch. Update your new branch using the following commands:
git checkout devel
git pull
make update
git checkout readme
git merge devel
# use something like `git mergetool` to resolve conflicts, then read the instructions for completing the merge (usually just a `git commit`)
# check the output of `git diff devel`
Thank you so much for your help to the decentralized and open source community. :)