Generic feedback

[gabesullice]

Hi @hibaymj!

I have some general feedback that I think would make this a lot easier to grok. Most of which I'm sure you're already aware of, so maybe this will just be a good todo list.

• README.md in the project root
• Table of Contents
• Headings (h1, h2, h3...) to make it easier to pick out conceptual "chunks"
• More newlines
• Glossary of terms
• More and smaller examples. It's fine to keep the long-form ones to "tie it all together" but there should be smaller ones for discrete pieces of this spec.
• The "long-form" examples need more commentary
• It's not clear why there are "prefer-based" and "profile-based" directories. Is that a decision yet to be made, or a choice for the implementor?

??? I'll add more as I can think of things.

[hibaymj]

I definitely plan to get this in a more standard format (IETF writer probably), but vim was all I had on hand overnight! Thanks for this feedback! I'll probably make a few separate issues for each of these items and tag you in them to discuss individually, but this is great! Thanks!

[hibaymj]

I updated the long form example in the prefer-based directory, as it was most relevant to the other conversations going on at the time.

Does this feedback still apply to the current state now, or was this from the profile-based directory?