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

ConfigBuilder: expand documentation #1390

Merged
merged 1 commit into from
Aug 7, 2023

Conversation

jsha
Copy link
Contributor

@jsha jsha commented Aug 3, 2023

De-emphasize the linker-friendliness in favor of explaining to the user what they need to do and in what order to do it.

Explicitly explain the type parameters.

Add separate intro sections for server and client.

Shorten examples by using with_safe_defaults() in examples that aren't talking about protocol primitives.

After filing #1372 I wanted to see how far we could get in the current paradigm with more documentation.

Rendered: https://rustdoc.crud.net/jsha/configbuilder-doc/rustls/struct.ConfigBuilder.html

@codecov
Copy link

codecov bot commented Aug 3, 2023

Codecov Report

Merging #1390 (4d975e7) into main (56cbc89) will decrease coverage by 0.03%.
Report is 14 commits behind head on main.
The diff coverage is n/a.

@@            Coverage Diff             @@
##             main    #1390      +/-   ##
==========================================
- Coverage   96.35%   96.32%   -0.03%     
==========================================
  Files          62       64       +2     
  Lines       14580    14734     +154     
==========================================
+ Hits        14049    14193     +144     
- Misses        531      541      +10     
Files Changed Coverage Δ
rustls/src/builder.rs 98.95% <ø> (ø)

... and 16 files with indirect coverage changes

📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more

Copy link
Member

@djc djc left a comment

Choose a reason for hiding this comment

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

This is great!

rustls/src/builder.rs Outdated Show resolved Hide resolved
Copy link
Member

@cpu cpu left a comment

Choose a reason for hiding this comment

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

Really nice cleanup! Thank you @jsha. I flagged one typo and made one suggestion to consider RE: ordering of text.

rustls/src/builder.rs Outdated Show resolved Hide resolved
rustls/src/builder.rs Show resolved Hide resolved
De-emphasize the linker-friendliness in favor of explaining to the user
what they need to do and in what order to do it.

Explicitly explain the type parameters.

Add separate intro sections for server and client.

Shorten examples by using with_safe_defaults() in examples that aren't
talking about protocol primitives.
@jsha jsha force-pushed the jsha/configbuilder-doc-update branch from 029deca to 4d975e7 Compare August 7, 2023 05:41
@cpu cpu added this pull request to the merge queue Aug 7, 2023
Merged via the queue into rustls:main with commit ef76fec Aug 7, 2023
21 checks passed
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