freeCodeCamp

Files

jaredwils 96915043e8 fix(docs): fixed link to within local build guide (#38577 )

* fix(docs): fixed link to within local build guide 

The link for "how to open a pull request" wasn't working to I fixed the link so that it takes you to a the proper place

* Update how-to-setup-freecodecamp-locally.md

2020-04-20 17:04:06 +05:30

components

docs: add flight manuals and tooling for docsify (#38510 )

2020-04-07 15:34:02 +05:30

flight-manuals

docs: add flight manuals and tooling for docsify (#38510 )

2020-04-07 15:34:02 +05:30

i18n-languages

revert(docs): Fixed Chinese broken link and markdown (#38458 )

2020-03-27 14:19:49 +05:30

images

[ImgBot] Optimize images (#37520 )

2019-10-31 17:54:30 +05:30

.nojekyll

feat(docs): host docs with docsify

2020-04-06 20:50:40 +05:30

CNAME

Create CNAME

2020-04-07 01:15:00 +05:30

devops.md

"artefact" to "artifact" (#38528 )

2020-04-11 20:45:22 -05:00

how-to-catch-outgoing-emails-locally.md

feat(docs): host docs with docsify

2020-04-06 20:50:40 +05:30

how-to-open-a-pull-request.md

feat(docs): host docs with docsify

2020-04-06 20:50:40 +05:30

how-to-setup-freecodecamp-locally.md

fix(docs): fixed link to within local build guide (#38577 )

2020-04-20 17:04:06 +05:30

how-to-use-docker-on-windows-home.md

feat(docs): host docs with docsify

2020-04-06 20:50:40 +05:30

how-to-work-on-coding-challenges.md

feat(docs): host docs with docsify

2020-04-06 20:50:40 +05:30

index.html

fix(docs): move contribute home (#38547 )

2020-04-14 16:17:33 +05:30

index.md

fix(docs): move contribute home (#38547 )

2020-04-14 16:17:33 +05:30

README.md

docs: update docs about docs

2020-04-14 17:14:12 +05:30

reply-templates.md

docs: update contributing guides (#36816 )

2019-09-20 23:56:56 +05:30

README.md

All our documentation and contributing guidlines are available on a dedicated site here: https://contribute.freecodecamp.org.

Looking to edit the contributing guidelines?

To work on the contributing guidelines, you can edit these files available here. 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.

How is the documentation site generated?

The documentation site is generated using docsify, 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:

The guideline homepage's source is index.html. GitHub Pages serve this file as a SPA using docsify.
The docsify script generates the content of markdown files in /docs directory on demand when you are browsing the documentation site.
The home page is genrated from the index.md and sidebar navigation is generated from components/sidebar.md.
To serve the docs locally:

Clone freeCodeCamp:
```
git clone https://github.com/freeCodeCamp/freeCodeCamp.git
docsify serve docs
```
Install docsify:
```
npm install -g docsify
```
and serve the /docs directory
```
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.