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

Consistent HTML tags for section titles #75

Merged
merged 5 commits into from Oct 4, 2016

Conversation

mostafah
Copy link
Contributor

@mostafah mostafah commented Oct 3, 2016

Had to close #71 because of a conflict. This is a new version of that. See that and #69 for discussion.

This commit now makes all titles follow what we agreed upon on those discussions, which is:

  • Start with h2 for each top-level section and go through smaller titles (h3, h4, …) for deeper sections.
  • Remove the occasional styles applied locally to titles.
  • Add ids to all sections.
  • Remove links to selves from headers.

The actual header tag used does not matter, because ReSpec would replace
them with something between <h1> to <h6> based on the level of their
section, but for the sake of consistency it's better to use a single
header everywhere. ReSpec says <h2> is sort of a tacit convention, so I
use that.
I deliberately skipped sections under "4.2 justification" because I have
another active pull request on them and wanted to avoid merge confict
with that. I'll update those sections on that PR. The reset are done
here.
Now <h1> is reserved for document title, <h2> for main chapters, <h3>
for subsections, ... .
@shervinafshar shervinafshar merged commit 129af62 into w3c:gh-pages Oct 4, 2016
@mostafah mostafah deleted the consistent-titles branch October 18, 2016 07:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants