Specification Readability #14
Description
This issue was discussed during a previous IG meeting and is on our list of things to resolve.
Currently, the specification is large and quite dense to read through. While technical documents are fine for like-minded individuals, it's not great for the public to wade through. Some efforts have already been made to improve the readability of the specification such as making the additional material related to guidelines visible on-demand (click-to-reveal) to reduce excessive scrolling (thus condensing over 200 pages!). However, more can be done. Work to improve the language usage within the text to make it easier to read (as one example), and education materials are on the list in another issue.
This issue has been opened to allow anyone to submit ideas for how we could make the spec more reader-friendly, taking note that we are rather restricted in style due to the ReSpec format, but if it's possible, I'll see what magic I can achieve.
Status Update:
- Role based labeling / filter system is currently under active development.
- @codewordcreative helping turn non-normative descriptions into normative intent subheadings.
- multipage is complete and functional (under active development).
- Turning the references into a nicely formatted (actively maintained) supplement.
Metadata
Metadata
Assignees
Type
Projects
Status