Add README

This commit is contained in:
mycognosist 2019-10-30 15:10:57 +00:00
parent 7966d51094
commit 86780d1da1
1 changed files with 26 additions and 0 deletions

26
README.md Normal file
View File

@ -0,0 +1,26 @@
# peach-devdocs
Developer documentation for PeachCloud in the form of a Markdown book.
### Setup
[mdBook](https://github.com/rust-lang/mdBook) is required to build and serve the book locally. Installation can be achieved via the [release binaries](https://github.com/rust-lang/mdBook/releases) or directly via Cargo (assuming you have Rust version 1.35 or higher and Cargo installed):
`cargo install mdbook`
Once mdBook is installed, clone this repo:
`git clone https://github.com/peachcloud/peach-devdocs`
Move into the repo, add the Cargo bin directory to your `PATH`, build and serve:
`cd peach-devdocs`
`export PATH=$PATH:~/.cargo/bin`
`mdbook build`
`mdbook serve`
The book is served on `localhost:3000` by default and refreshes automatically in-browser when changes to the documentation are saved.
### Licensing
AGPL-3.0