Open TimonPost opened 3 years ago
A couple quick notes:
easy-rsa for a DIY certificate authority
~This should be dropped in favor of rcgen.~ Actually, on second thought, I don't think rcgen has a convenient CLI (yet?) so it's probably worth mentioning them both and linking docs.
Streams - Application datagrams
We shouldn't describe these as a type of stream, though we should definitely discuss them and compare/contrast to unidirectional streams.
What would you propose as a topic name instead of streams?
Maybe something like "Data transfer"?
(Note that your capitalization is pretty inconsistent here. I would prefer that we consistently just use "Single capital letter per title" rather than "Capitals For Every Word".)
Good point for when I am going to work on them. Those titles are still a draft and are mostly a copy of @Ralith proposal in the other issue. I created two lists one with topics that are definitive and a list with ideas. I will try to keep that first list as close to the real book index as possible.
Locally I have a branch ready for the Networking Introduction. I will be working on the Quinn section now. When this PR quinn-rs/quinn#868 is merged I can create a pull request for it because those chapters build up on each other.
This issue describes all the sections the new MD-book will contain. It belongs to a bigger overall documentation project as described here: #861.
The draft book can be found here. I will create PR's for individual pages if they are done. If you think that something could be added or have any ideas for improvement you could share it in this issue. It isn't definitive but feedback is welcome.
Definitive List of topics
(selected means written, [#000] means it has a PR already. I have some local branches queued up.
Ideas for possible subjects