Just#

Applies to Linux and Windows

2024-06-24

2 min read time

just is a command runner used to quickly setup an environment for documentation development.

The aim is to make contributing to rocm-docs-core more approachable by providing ready-to-use environments for development.

Usage#

Setting up a development environment#

just devenv

This creates a Python virtual environment, installs the dependencies, and sets up the pre-commit hooks.

Running linting commands#

These commands work on both Linux and Windows

just check-codestyle

Check files for formatting errors and report them.

just fix-codestyle

Automatically fix errors that have suggested fixes.

GitHub#

GitHub Actions CI is extended to run these tools on PRs (using the just-based entry-points).

Development container setup and settings are added for Visual Studio Development containers (and GitHub Codespaces) and Gitpod.