ASCII art in source files is not helpful

[chaals]

The source files generally start with a giant ASCII art version of the name, in a comment.

It is not always legible, and in any event it doesn't provide much in the way of value. It would be more helpful to describe the source file, what it contains, and where it ends up in the spec, for example

<!--
This is the source file for https://w3c.github.io/html/introduction.html

All the content is "non-normative". It contains
- a background / potted history of HTML
- a few design notes
- a note on HTML and XML syntax
- information on how the spec is written and how to read it
- some privacy considerations
- an introduction to HTML itself, how to write it, etc.
- non-normative conformance requirements for content
- links to some other specs: charmod, unicode security, and some accessibility specs
-->

• acknowledgements.include
• attributes.include
• browsers.include
• changes.include
• dom.include
• editing.include
• element-content-categories.include
• element-interfaces.include
• elements.include
• events.include
• iana.include
• infrastructure.include
• introduction.include
• obsolete.include
• rendering.include
• semantics-common-idioms.include
• semantics-document-metadata.include
• semantics-edits.include
• semantics-embedded-content.include
• semantics-forms.include
• semantics-grouping-content.include
• semantics.include
• semantics-interactive-elements.include
• semantics-links.include
• semantics-root.include
• semantics-scriptings.include
• semantics-sections.include
• semantics-tabular-data.include
• semantics-textlevel.include
• syntax.include
• webappapis.include
• xhtml.include

[arpit7714]

what to do ??

[chaals]

I filed one PR that covers the introduction chapter - #1202

I am trying to get another one through my temporarily blocked up machine, covering the other items I ticked off the list.

Anyone should feel free to tick something off and file a PR to cover it...

[scottaohara]

@chaals I was going to try to take care of a few of these over the weekend. Would you rather I piggy back off your existing PR, or create a PR of my own changes?

Thanks

[chaals]

Easier if you make your own I think, although I am not that fussed. I started ticking off items as I was about to do them, which might help.