gaspersic/freeCodeCamp
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

docs: update docs about docs

Browse Source
This commit is contained in:
Mrugesh Mohapatra 2020-04-14 17:14:12 +05:30
parent a8203d9f1a
commit d302fc94e0
2 changed files with 36 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
CONTRIBUTING.md
View File

@ -1,4 +1,7 @@
> ### All our documentation and contributing guidlines are available on a dedicated site here: <https://contribute.freecodecamp.org>.
> ### Our contributing guidelines are available here: <https://contribute.freecodecamp.org>
### Looking to edit the contributing guidelines?
Looking to edit the contributing guidelines? The source is [available here](https://github.com/freeCodeCamp/freeCodeCamp/tree/master/docs).
To work on the contributing guidelines, you can edit these files [available here](https://github.com/freeCodeCamp/freeCodeCamp/tree/master/docs). When your changes are merged, it will be made available automatically at the documentation site linked above.
**You do not need to setup anything locally for working on the documentation.**

42
docs/README.md
View File

@ -1,17 +1,37 @@
> ### Our contributing guidelines are available here: <https://contribute.freecodecamp.org>
> ### All our documentation and contributing guidlines are available on a dedicated site here: <https://contribute.freecodecamp.org>.
Looking to edit the contributing guidelines? The source is [available here](https://github.com/freeCodeCamp/freeCodeCamp/tree/master/docs).
### Looking to edit the contributing guidelines?
They are created using [docsify](https://docsify.js.org). The guideline homepage's source is [index.html](index.html), which generates the page from the content in [index.md](index.md).
To work on the contributing guidelines, you can edit these files [available here](https://github.com/freeCodeCamp/freeCodeCamp/tree/master/docs). When your changes are merged, it will be made available automatically at the documentation site linked above.
To run the docs locally, install `docsify`
**You do not need to setup anything locally for working on the documentation.**
```bash
npm i -g docsify
```
### How is the documentation site generated?
and then use
The documentation site is generated using [`docsify`](https://docsify.js.org), and served using GitHub pages. Typically you would not need to change any configuration, or build the site locally, but incase you are interested here is how it works:
```bash
docsify serve docs
```
1. The guideline homepage's source is [`index.html`](index.html). GitHub Pages serve this file as a SPA using `docsify`.
2. The `docsify` script generates the content of `markdown` files in `/docs` directory on demand when you are browsing the documentation site.
3. The home page is genrated from the [`index.md`](index.md) and sidebar navigation is generated from [`components/sidebar.md`](components/sidebar.md).
4. To serve the docs locally:
Clone freeCodeCamp:
```sh
git clone https://github.com/freeCodeCamp/freeCodeCamp.git
docsify serve docs
```
Install `docsify`:
```sh
npm install -g docsify
```
and serve the `/docs` directory
```sh
docsify serve docs
```
Alternatively, if you have installed freeCodeCamp locally (see the local setup guide), we bundle the CLI with the development tools so you can run `npm run docs:serve` from the root of the repo.