mdn / mdn/content

Reference page titles are not consistent and need improvements

Open
#39,894 16 comments 1 reaction 0 assignees View on GitHub
Content:HTML needs decision
Dominant language
Markdown
Stars
11k
Forks
23.2k
Avg merge
2d 9h
Merged PRs (30d)
331

Description

### MDN URL

https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/is

### What specific section or headline is this issue about?

Title

### What information was incorrect, unhelpful, or incomplete?

Here is a conversation from chat channel:

> Chen Sida: Just discovered this great page title:
[HTML is global attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Global_attributes/is)
It's giving off "ceci n'est pas une pipe" vibes (edited)
>
> ------------------------------------
> onkar ruikar: Shouldn't it be one of the following:
> - is: HTML global attribute
> - HTML global attribute: is
>
> Global attrs pages should have titles like normal attrs pages," https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Attributes/for
>
>-----------------------------------
> Will Bamberg:
>> HTML global attribute: is
>
> Ah, the Yoda title variant.

I'm not sure if Will is suggesting using the second version or if it's just a pun.

### What did you expect to see?

- [ ] Decide on a fixed format for titles on all the MDN pages
- ` is: HTML global attribute`
- `HTML global attribute: is`
- [ ] The HTML global attribute pages should have titles consistent with other technology pages like API pages.
- [ ] CSS pages to use `CSS property: abcd` format: https://developer.mozilla.org/en-US/docs/Web/CSS/border-left
- [ ] API pages don't have consistant titles, for example:
- https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/enterKeyHint
- https://developer.mozilla.org/en-US/docs/Web/API/IdleDeadline
- https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/title
- https://developer.mozilla.org/en-US/docs/Web/API/PopStateEvent

### Do you have any supporting links, references, or citations?

_No response_

### Do you have anything more you want to share?

With a fixed format in place, titles can be linted.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.