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

Document everything #126

Merged
merged 4 commits into from Sep 13, 2022
Merged

Document everything #126

merged 4 commits into from Sep 13, 2022

Conversation

g2p
Copy link
Contributor

@g2p g2p commented Sep 9, 2022

This is an updated and rebased version of #82.

I couldn't turn on #![deny(missing_docs)] for the whole crate because the test_helpers feature exposes about 138 undocumented qpack and proto functions.

Refactoring the tests to be part of the original crate would fix that (and remove the need to backdoor module privacy). I added the #[deny(missing_docs)] attribute to the rest of the modules instead.

Also updated draft references to point to published RFCs.

Motivation for the pull request is that I would like a preliminary release of the crate; see #125, and #70 before that.

@g2p g2p force-pushed the document-everything branch 3 times, most recently from dd29f12 to e7fdf2d Compare September 9, 2022 16:40
Copy link
Contributor

@Ruben2424 Ruben2424 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good from my perspective.

README.md Outdated Show resolved Hide resolved
h3/src/client.rs Outdated Show resolved Hide resolved
@g2p
Copy link
Contributor Author

g2p commented Sep 12, 2022

@Ruben2424, I followed your suggestions

Copy link
Contributor

@Ruben2424 Ruben2424 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good here. Thank you. 💪

@seanmonstar
Copy link
Member

Woops, sorry, just merged a different PR that caused some conflicts here.

@g2p changes:
Run cargo fmt, rebase and fix conflicts, fix draft doctests,
remove overly incomplete draft tests.
I couldn't turn on #![deny(missing_docs)] for the whole crate because
the test_helpers feature exposes about 138 undocumented qpack/proto
functions.

Refactoring the tests to be part of the original crate would fix that.

Changed the RequestEnd struct to not be public, it is an internal struct
used to notify the connection of closed streams.
Changed some citations to match published versions.
Changes were editorial as far as I could tell.
@g2p
Copy link
Contributor Author

g2p commented Sep 13, 2022

Rebased, then fixed some issue with an URL that broke the format duvet report expected.

@seanmonstar seanmonstar merged commit 04de4f8 into hyperium:master Sep 13, 2022
@seanmonstar
Copy link
Member

Thanks again <3

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.

None yet

4 participants