Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: Add docs for ToChildren #2643

Merged
merged 2 commits into from
Jun 26, 2024
Merged

Conversation

spencewenski
Copy link
Contributor

As discussed in #2640, the ToChildren trait is useful to consumers who want to use the builder syntax. However, because it is currently annotated with #[docs(hidden)], it's not visible in docs and also not included in Jetbrains's auto-complete.

Add a doc comment for the ToChildren trait, including doc tests that demonstrate how to use the trait and how it compares to directly creating children.

As discussed in leptos-rs#2640,
the `ToChildren` trait is useful to consumers who want to use the
builder syntax. However, because it is currently annotated with
`#[docs(hidden)]`, it's not visible in docs and also not included in
Jetbrains's auto-complete.

Add a doc comment for the `ToChildren` trait, including doc tests that
demonstrate how to use the trait and how it compares to directly
creating children.
@spencewenski spencewenski changed the title Add docs for ToChildren docs: Add docs for ToChildren Jun 21, 2024
leptos/src/children.rs Outdated Show resolved Hide resolved
Some examples were added to `ToChildren` that don't compile. This
wasn't caught earlier because no errors were seen in the IDE when
writing the examples. The issue was correctly caught by CI, however.
@spencewenski
Copy link
Contributor Author

Hey @gbj , I believe I resolved the issue that was causing the checks to fail. Can you re-run the workflow and review when you get a chance? Thanks!

@benwis
Copy link
Contributor

benwis commented Jun 26, 2024

LGTM. Thanks for the PR

@benwis benwis merged commit 57a00a3 into leptos-rs:main Jun 26, 2024
59 checks passed
@spencewenski spencewenski deleted the to-children-docs branch June 26, 2024 22:44
@gbj gbj mentioned this pull request Jul 8, 2024
35 tasks
@gbj gbj mentioned this pull request Aug 5, 2024
26 tasks
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants