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

Remove the glossary? #117

Closed
ekr opened this issue Dec 30, 2014 · 6 comments
Closed

Remove the glossary? #117

ekr opened this issue Dec 30, 2014 · 6 comments

Comments

@ekr
Copy link
Contributor

ekr commented Dec 30, 2014

Is this helping?

@davegarrett
Copy link
Contributor

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:
https://http2.github.io/http2-spec/index.html#rfc.section.2.2

This seems like a better way to do this.

@davegarrett
Copy link
Contributor

Not sure if this is the best route, but creating a PR for it was quick to do.

@seanturner
Copy link
Contributor

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.

@richsalz
Copy link
Contributor

Define resumption in-line with the text when it is first used, maybe. But I like Dave's change.

@seanturner
Copy link
Contributor

I can live with that too. Having it defined will hopefully stop these kind of things:
https://datatracker.ietf.org/liaison/1363/

@ekr
Copy link
Contributor Author

ekr commented May 16, 2015

Merged.

@ekr ekr closed this as completed May 16, 2015
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

No branches or pull requests

4 participants