google / google/xls

[enhancement] bazelify docs build process

Open
#1,690 0 comments 0 reactions 0 assignees View on GitHub
enhancement
Dominant language
C++
Stars
1.9k
Forks
283
Avg merge
2d 10h
Merged PRs (30d)
135

Description

### What's hard to do? (limit 100 words)

Currently the doc build process is defined in a recurring github workflows https://github.com/google/xls/blob/main/.github/workflows/build-mkdocs-commit-html.yml, making it difficult to troubleshoot it locally or running it from other workflows (CI).

### Current best alternative workaround (limit 100 words)

Duplicate environment setup locally or in other workflows.

### Your view of the "best case XLS enhancement" (limit 100 words)

Ideally the environment setup and build process would be done within bazel allowing us to share the environment setup and make the doc build process hermetic, shared and reproducible locally.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.