Skip to content

Conversation

alexislefebvre
Copy link
Contributor

It looks like an “l” and it's unnecessary:

image

@carsonbot carsonbot added this to the 6.4 milestone Sep 6, 2025
@carsonbot carsonbot changed the title doc: remove uppercase in yaml.rst doc: remove uppercase in yaml.rst Sep 6, 2025
@javiereguiluz
Copy link
Member

We might have to fix this in a different way. I asked GPT-5:

In Symfony Docs, the recommended spelling for that heading in title case would be:

What Is It?

Reasoning:

Symfony Docs follow [title case rules][1], which are based on the Chicago Manual of Style:

* Capitalize the first and last word.
* Capitalize all major words (nouns, pronouns, verbs, adjectives, adverbs, subordinating conjunctions).
* Lowercase short articles, coordinating conjunctions, and prepositions (unless they're the first/last word).

So in your case:

* "What" → capitalized (first word, interrogative pronoun)
* "Is" → capitalized (verb)
* "It" → capitalized (pronoun)

[1]: https://symfony.com/doc/current/contributing/documentation/standards.html#headings

@alexislefebvre
Copy link
Contributor Author

I think it doesn't look great when each word start with uppercase, because of the uppercase “i”:

image

@javiereguiluz javiereguiluz merged commit e94a4bb into symfony:6.4 Sep 10, 2025
3 checks passed
@javiereguiluz
Copy link
Member

javiereguiluz commented Sep 10, 2025

Alexis, at the end I removed this headline entirely while merging. It's not necessary and the intro now looks better. Also, I didn't add a reference to keep the "anchor link" for existing links because browsers go back to the beginning of the page when the anchor link is missing, so there would be no difference. Thanks!

@alexislefebvre alexislefebvre deleted the patch-2 branch September 10, 2025 15:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants