docs.px.dev ·

This repo contains the source code and content for the Pixie Docs website.

Reporting Issues

Submit any issues or enhancement requests by filing an issue. Please search for and review the existing open issues before submitting a new issue.

Contributing

We're excited to have you contribute to Pixie's documentation!

Pixie has adopted the Contributor Covenant as its code of conduct, and we expect all participants to adhere to it. Please report any violations to [email protected]. All code contributions require the Contributor License Agreement. The CLA can be signed when creating your first PR.

Dev Setup

To run in development mode, run the following commands:

yarn install
yarn start

Then visit http://localhost:8000/ to view the app.

To generate a production build, run:

yarn install
yarn build

Updating Automated Content

To pull the latest reference docs, run:

./update_docs.sh

This will overwrite external/pxl_documentation.json. Add the changed file to the repo and submit a pull request.

Deploy Previews

Once you submit a pull request to this repo, Netlify creates a deploy preview for the changes in the specific PR. You can view the deploy preview in the Netlify panel that appears under the PR description.

Publishing the Site

The Pixie website is published automatically by Netlify. Whenever changes are merged into the prod branch, Netlify re-builds and re-deploys the site.

Documentation License

This work is licensed under a Creative Commons Attribution 4.0 International License.

Please note the Creative Commons Attribution 4.0 license applies to the creative work of this site (documentation, visual assets, etc.) and not to the underlying code and does not supersede any licenses of the source code, its dependencies, etc.