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

doc: add information about s2n-tls software architecture #4868

Merged
merged 11 commits into from
Nov 19, 2024

Conversation

boquan-fang
Copy link
Contributor

Resolved issues:

The usage guide doesn't have documentations for general s2n-tls software architecture.

Description of changes:

I have updated our usage-guide to include documentation about s2n-tls high level software architecture. Since the architecture mostly involves s2n_connection and s2n_config, I decided to create a new markdown file for software architecture before the connection usage guide. Therefore, I need to rename those documentations after the connection usage guide.

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

* add software architecture md file
* insert the file before connection doc
* move those general docs to config and connection chapters
* move config chapter in front of the connection chapter
docs/usage-guide/topics/SUMMARY.md Outdated Show resolved Hide resolved
docs/usage-guide/topics/ch04-config.md Outdated Show resolved Hide resolved
docs/usage-guide/topics/ch04-config.md Outdated Show resolved Hide resolved
docs/usage-guide/topics/ch04-config.md Outdated Show resolved Hide resolved
docs/usage-guide/topics/ch05-connection.md Outdated Show resolved Hide resolved
* remove some repeating sentences
* rephrase some sentences to make them read more precise
docs/usage-guide/topics/ch04-connection.md Outdated Show resolved Hide resolved
docs/usage-guide/topics/ch05-config.md Outdated Show resolved Hide resolved
docs/usage-guide/topics/ch05-config.md Outdated Show resolved Hide resolved
* make doc wording more precise based on comments
docs/usage-guide/topics/ch05-config.md Outdated Show resolved Hide resolved
docs/usage-guide/topics/ch04-connection.md Outdated Show resolved Hide resolved
* add software architecture information on top of the connection chapter
* resolve a nit
docs/usage-guide/topics/ch04-connection.md Outdated Show resolved Hide resolved
docs/usage-guide/topics/ch11-resumption.md Outdated Show resolved Hide resolved
docs/usage-guide/topics/ch05-config.md Outdated Show resolved Hide resolved
* remove repetitive sentences, and make wording more precise.
* link relevant sections to software architecture's overview.
* change wording
* move software architecture section to proper position
* give general introductions about connection and config
* rewrite the connection explanation for it to be more general
* explain connection is established by handshake, and how config
  interacts with a connection
docs/usage-guide/topics/ch04-connection.md Outdated Show resolved Hide resolved
@boquan-fang boquan-fang enabled auto-merge (squash) November 19, 2024 00:14
@boquan-fang boquan-fang merged commit ed58a00 into aws:main Nov 19, 2024
37 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants