crate / crate-docs

Common build system, QA tools, style guides, and other meta miscellanies for doing docs at Crate.io.
Apache License 2.0
2 stars 1 forks source link
build docs qa style-guide

============================ CrateDB Documentation System

|version| |ci| |rtd|

Build system, authoring, and QA tools, and a style guide for the CrateDB documentation_.

🧐 What's Inside

Usage

πŸ€ Tools

A few operational tasks are defined within the top-level tasks.py file. After setup::

git clone https://github.com/crate/crate-docs
cd crate-docs
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

you can display a list of available tasks using::

invoke --list

There is also tooling to support Technical Writing on HubSpot_.

πŸ”— Intersphinx

For displaying intersphinx_ inventories to learn about available link targets, run commands like this::

invoke inv https://cratedb.com/docs/crate/reference/en/latest/objects.inv
invoke allinv --format=markdown
invoke allinv --format=html+table

Contributing

This project is primarily maintained by Crate.io_, but we welcome community contributions!

See the developer docs and contributor docs for more information.

Help

Looking for more help?

.. |version| image:: https://img.shields.io/endpoint.svg?color=blue&label=docs%20build%20version&url=https://raw.githubusercontent.com/crate/crate-docs/main/docs/build.json :alt: Build version :target: https://github.com/crate/crate-docs/blob/main/docs/build.json

.. |ci| image:: https://github.com/crate/crate-docs/workflows/docs/badge.svg :alt: CI status :target: https://github.com/crate/crate-docs/actions/workflows/docs.yml

.. |rtd| image:: https://readthedocs.org/projects/crate-docs/badge/?version=latest :alt: Read The Docs status :target: https://readthedocs.org/projects/crate-docs

.. _Code of Conduct: CONTRIBUTING.rst .. _contributor docs: CONTRIBUTING.rst .. _Crate.io: https://cratedb.com/ .. _CrateDB documentation: https://cratedb.com/docs/ .. _developer docs: DEVELOP.rst .. _github-projects.txt: registry/github-projects.txt .. _intersphinx: https://www.sphinx-doc.org/en/master/usage/extensions/intersphinx.html .. _Sphinx: http://www.sphinx-doc.org/en/stable/ .. _sphinx-inventories.txt: registry/sphinx-inventories.txt .. _support channels: https://cratedb.com/support/ .. _Technical Writing on HubSpot: https://github.com/crate-workbench/hubspot-tech-writing