Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/grafana/k6-docs
The k6 documentation website.
https://github.com/grafana/k6-docs
devops docs hacktoberfest k6 performance-testing reliability-engineering
Last synced: 5 days ago
JSON representation
The k6 documentation website.
- Host: GitHub
- URL: https://github.com/grafana/k6-docs
- Owner: grafana
- Created: 2020-04-17T11:58:42.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-10-28T20:36:16.000Z (about 1 month ago)
- Last Synced: 2024-10-29T14:48:06.606Z (about 1 month ago)
- Topics: devops, docs, hacktoberfest, k6, performance-testing, reliability-engineering
- Language: JavaScript
- Homepage: https://grafana.com/docs/k6/latest/
- Size: 77.9 MB
- Stars: 88
- Watchers: 143
- Forks: 218
- Open Issues: 188
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING/README.md
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS
Awesome Lists containing this project
- jimsghstars - grafana/k6-docs - The k6 documentation website. (JavaScript)
README
# k6 Documentation
Welcome to the k6 docs!
This repo contains the source code of the [k6 documentation](https://grafana.com/docs/k6/).
Some key facts:
- Issues and contributions are **always welcome**!
- The docs are written in Markdown and built with Hugo.
- The [Contributor's guide](./CONTRIBUTING) has meta-documentation about building locally, using special components and styling, deploying, troubleshooting, and more.
- We have a [Code of conduct](https://github.com/grafana/k6-docs/blob/main/CODE_OF_CONDUCT.md).
- We follow the Grafana Style Guide, and you can find more information about it in the [Writers' Toolkit](https://grafana.com/docs/writers-toolkit/).
## Contributing
Don't feel shy about contributing! All input is welcome. No fix is too trivial.
If something confuses you or feels lacking about the docs, make an issue.
If you find something that you think you can fix, please go ahead. You don't need to ask permission.
Markdown files for the documentation are located in the [`docs/sources/`](docs/sources) folder, with sub-folders for each k6 version. The URL structure is generated based on the folder structure and file names.
For small changes and spelling fixes, the GitHub UI is the most convenient way to contribute.
For larger contributions, consider running the project locally to see how the changes look like before making a pull request.
The following docs cover the different stages of the writing workflow:
- [Local development](#local-development). For any large changes, being able to see a preview of the site can help make sure things are rendered correctly, and spot any issues before they're deployed to production.
- [Writers' Toolkit](https://grafana.com/docs/writers-toolkit/). Learn more about the Grafana writing style guide, front matter properties, how to upload and add images, and much more.
- [Preview and deploy](./CONTRIBUTING#deploy). Changes made to the files inside of `docs/sources` are automatically deployed to production once they're merged to the main branch.
For more details, refer to the [CONTRIBUTING](./CONTRIBUTING/README.md) section.
## Local development
### Before you begin
To build the k6 docs in your machine, you'll need:
- [Docker](https://docs.docker.com/engine/install/) or [Podman](https://podman.io/docs/installation)
If you're using Docker, make sure you have the Docker Desktop application running.
### Build and preview
Clone the repository to your machine:
```bash
git clone https://github.com/grafana/k6-docs.git
```
Run `npm start`:
```bash
npm start
```
You should see an output similar to this when the site finishes building:
```bash
View documentation locally:
http://localhost:3002/docs/k6/
Press Ctrl+C to stop the server
```
Go to http://localhost:3002/docs/k6/, and you should be able to see a preview of the docs.