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

Consider consolidating subsections for each Resource Record definition #6

Open
vttale opened this issue Mar 7, 2017 · 1 comment
Open
Labels

Comments

@vttale
Copy link
Collaborator

vttale commented Mar 7, 2017

Sections 5, 6, and 7, defining the NSEC5KEY, NSEC5, and NSEC5PROOF RRs respectively, could be tightened up by not using subsections for wire format and presentation format. Of course, each record would still have its own section.

The subsections break up the flow and, while convenient for external references, are also not really long enough that someone following an external reference that intended to focus on, say, presentation format, would have trouble finding what they were looking for in each consolidated section.

@vttale
Copy link
Collaborator Author

vttale commented Mar 7, 2017

Relatedly, typographically it is kind of weird that lines like "The presentation format of the NSEC5 RDATA is as follows:" end in a colon that introduces paragraphs. I'd make them some kind of list, probably definition lists.

@fcelda fcelda added the NSEC5 label Jun 17, 2017
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

No branches or pull requests

2 participants