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
Remove the glossary? #117
Comments
Glossaries are usually a good thing, but pretty much everything in there is either in need of pruning out or is better explained in its relevant section. The HTTP/2 spec just includes a really short glossary of basic terms up top: This seems like a better way to do this. |
Not sure if this is the best route, but creating a PR for it was quick to do. |
I'm in favor of removing the glossary. I don't think there's any need to explain what AES, DSA, etc. is in this document. Maybe it was needed when it first came out but it's not needed now. The only definition I thought might be needed is application layer/application layer protocol, but if you read s1 (right before where these terms will go) the concepts of layering on top of TLS is explained well enough in my mind. I could see adding a definition for "resumption" though. |
Define resumption in-line with the text when it is first used, maybe. But I like Dave's change. |
I can live with that too. Having it defined will hopefully stop these kind of things: |
Merged. |
Is this helping?
The text was updated successfully, but these errors were encountered: