mirror of
https://github.com/bevyengine/bevy
synced 2024-11-10 07:04:33 +00:00
Document private items in dev-docs (#14769)
# Objective - The [developer docs](https://dev-docs.bevyengine.org) are primarily used by developers, who often deal with internal and private functions. - @mweatherley suggested [on Discord](https://discord.com/channels/691052431525675048/743559241461399582/1273658470134186112) that CI passes `--document-private-items` to the dev-docs, so contributors can easily browse these internal details. ## Solution - Add `--document-private-items` to the CI job that builds the dev-docs. ## Testing - It should run in CI and generate documentation for private code. ## Drawbacks - Users that track the main branch may use the dev-docs instead of <https://docs.rs/bevy>, which may now show a lot of unwanted internal details. - Searching may be slower / bloated with internal details.
This commit is contained in:
parent
eec38004a8
commit
2012f13c05
1 changed files with 1 additions and 0 deletions
1
.github/workflows/docs.yml
vendored
1
.github/workflows/docs.yml
vendored
|
@ -67,6 +67,7 @@ jobs:
|
||||||
--all-features \
|
--all-features \
|
||||||
--workspace \
|
--workspace \
|
||||||
--no-deps \
|
--no-deps \
|
||||||
|
--document-private-items \
|
||||||
--exclude ci \
|
--exclude ci \
|
||||||
--exclude errors \
|
--exclude errors \
|
||||||
--exclude bevy_mobile_example \
|
--exclude bevy_mobile_example \
|
||||||
|
|
Loading…
Reference in a new issue