-
Notifications
You must be signed in to change notification settings - Fork 36
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
Omit unnecessary elements in the dev edition #52
Conversation
Omits the small TOC, fingerprint markers, and <pre class=idl> blocks. Part of #27.
Right now CSS is still hiding the TOC elements below level 2; that's probably fixable too... |
Do web developers really not want to see IDL blocks? It seems to me there would be weird stuff surrounding the missing IDL blocks; those should be handled with |
IDL blocks are certainly omitted in developers.whatwg.org. I think they do not; they are pretty meaningless, using terms like The main IDL blocks that get hidden by this are the ones in the element intro boxes. Most others are already hidden with w-nodev. |
OK. So maybe we should instead add Possibly the element boxes in dev edition should say "DOM interface: Uses HTMLPictureElement" instead of the full IDL block? |
Upon closer inspection, I think it's in many cases OK to remove IDL blocks, so this change is OK. But there are some tweaks we should do to |
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.
Given the main point of the developer edition as far as its content goes is to reduce the amount of information that developers have to wade through that’s not essential to their information needs, I agree it makes sense to omit the IDL. Developers who want to the see the IDL can always read the full spec.
Omits the small TOC, fingerprint markers, and
<pre class=idl>
blocks.Part of #27.