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
A Transport Services System, architecture, and Transport Services Implementation #1288
Conversation
This document has been edited many ways, and this PR proposes a change in title and refinement in the use of the word 'architecture' to focus on the system specification, rather than the architectural principles. It does not intend to change the system in any way, this is intended as a language revision, to make it slightly less philosophical.
Happy also to muse with this change /Transport Services system/Transport Services System/ is people wish this... |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Many small suggestions... the most prevalent one being capitalization of the "System". I do this because you added it to the glossary, with capitals... and it makes sense to be added there, but then it really must be capitalized everywhere, I believe.
Co-authored-by: mwelzl <michawe@ifi.uio.no>
Co-authored-by: mwelzl <michawe@ifi.uio.no>
Co-authored-by: mwelzl <michawe@ifi.uio.no>
Co-authored-by: mwelzl <michawe@ifi.uio.no>
Co-authored-by: mwelzl <michawe@ifi.uio.no>
Co-authored-by: mwelzl <michawe@ifi.uio.no>
Co-authored-by: mwelzl <michawe@ifi.uio.no>
Co-authored-by: mwelzl <michawe@ifi.uio.no>
Co-authored-by: mwelzl <michawe@ifi.uio.no>
Co-authored-by: mwelzl <michawe@ifi.uio.no>
This capitalises "Transport Services System". Removes most confusion between system and implementation. Removes two definitions of these, the second one simply becoming text rather than definition. Hopefully now in a fit state for reading!
Please also add the "Transport Services Implementation" to the glossary. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
A few tiny ones. Ok for me to merge if you agree with these.
Co-authored-by: mwelzl <michawe@ifi.uio.no>
Co-authored-by: mwelzl <michawe@ifi.uio.no>
Co-authored-by: mwelzl <michawe@ifi.uio.no>
Some phrases are about the architecture of the system, but others are about the system itself, and some others about the implementation below the API. These are separate concepts, and this revision seeks to ensure we use them consistently where possible
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
(As an individual)
Just read over the changes and tripped over a few typos.
Co-authored-by: Reese Enghardt <ietf@tenghardt.net>
Co-authored-by: Reese Enghardt <ietf@tenghardt.net>
Co-authored-by: Tommy Pauly <tpauly@apple.com>
Co-authored-by: Colin Perkins <csp@csperkins.org>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks good modulo nits
This document has been edited many ways, and this PR proposes a change in title and refinement in the use of the word 'architecture' to focus on the system specification, rather than the architectural principles. It does not intend to change the system in any way, this is intended as a language revision, to make it slightly less philosophical.
This is part 1 of addressing Eric's DISCUSS - the other part could be a title change, but this PR needs to land first because it will conflict with other development of text