bevy/.github
BD103 2012f13c05
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.
2024-08-15 20:57:49 +00:00
..
actions/install-linux-deps Fix common capitalization errors in documentation (#14562) 2024-07-31 21:16:05 +00:00
contributing Fixed #14248 and other URL issues (#14276) 2024-07-11 12:01:49 +00:00
example-run Test for ambiguous system ordering in CI (#13950) 2024-07-17 21:05:48 +00:00
ISSUE_TEMPLATE Add a performance regression issue template (#8279) 2023-04-04 01:04:18 +00:00
linters meta: Add Showcase section to PR template (#11750) 2024-07-08 01:23:24 +00:00
start-mobile-example Remove unused variable (#10966) 2023-12-13 20:41:45 +00:00
start-wasm-example Fix common capitalization errors in documentation (#14562) 2024-07-31 21:16:05 +00:00
workflows Document private items in dev-docs (#14769) 2024-08-15 20:57:49 +00:00
dependabot.yml dependabot: use new C-Dependencies label 2021-07-13 12:51:48 -07:00
FUNDING.yml Update funding link (#12425) 2024-03-11 21:46:04 +00:00
pull_request_template.md meta: Add Showcase section to PR template (#11750) 2024-07-08 01:23:24 +00:00