This repository holds source code for Kong's documentation website. It's built using Jekyll and deployed with Netlify.
Here are some things to know before you get started:
-
We're beginner-friendly. Whether you're a Technical Writer getting into code-as-docs or an engineer practicing your documentation skills, we highly encourage your involvement in our project. If you'd like to contribute and don't have something in mind already, head on over to Issues. We've added
good first issuelabels on beginner-friendly issues. -
We need more help in some areas. We'd especially love some help with plugin documentation.
-
Some of our docs are auto-generated.
All PRs for these docs should be opened over at the Kong/kong repository.
For Gateway Enterprise configuration reference and PDK reference documentation, open an issue on this repo and we'll update the docs.
- Community is a priority for us. Before submitting an issue or PR, please review our Contributing Guide.
For anything other than minor changes, clone the repository onto your local machine and build locally. We offer the option to run your project locally with Docker, gulp, and npm.
- Docker (You will not need to run the Docker container via Docker Desktop.)
Start the Docker container (this installs dependencies for you and may take a few minutes):
make develop
If you have issues, run:
make clean
- gulp installed globally
Install dependencies:
make install
Run the project:
make run
If you have issues, run:
make clean
Install dependencies:
gem install bundler
npm install
Run the project:
npm start
If you have contributed a plugin, we welcome you to add a Kong badge to your plugin README.
Use the following, where you replace test with your plugin name and link-to-docs with a link to the Kong docs for your plugin.
[](link-to-docs)
Here's how the badge looks:
See Issue #908 for more information. Note that we're not currently hosting assets for badges.
This section is for Kong source code maintainers. You won't need to do anything here if you're contributing to this repo!
The PDK docs, Admin API docs, cli.md and configuration.md for each release are generated from the Kong source code.
To generate them, go to the Kong/kong repo and run:
scripts/autodoc <docs-folder> <kong-version>
For example:
cd /path/to/kong
scripts/autodoc ../docs.konghq.com 2.4.x
This example assumes that the Kong/docs.konghq.com repo is cloned into the
same directory as the Kong/kong repo, and that you want to generate the docs
for version 2.4.x. Adjust the paths and version as needed.
After everything is generated, review, open a branch with the changes, send a pull request, and review the changes.
You usually want to open a PR against a release/* branch. For example, in the
example above the branch was release/2.4.
cd docs.konghq.com
git fetch --all
git checkout release/2.4
git checkout -b release/2.4-autodocos
git add -A .
git commit -m "docs(2.4.x) add autodocs"
git push
Then open a pull request against release/2.4.