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

Fix: Reduce proselint warnings #1966

Open
wants to merge 2 commits into
base: 3.3
Choose a base branch
from

Conversation

pieterocp
Copy link

@pieterocp pieterocp commented Aug 13, 2024

This addresses all the easily addressable proselint-able issues (on the basis that if there is a tool linting, getting it down to zero or as close to makes any increase jump out). I've gone with a marked version over main as this is a bug fix? Not sure.

The three remaining are a bit on the fiddly side:

./admin/index.md:5:87: garner.phrasal_adjectives.ly No hyphen is necessary in phrasal adjectives with an adverb ending in -ly, unless the -ly adverb is part of a longer phrase
./deployment/docker-compose.md:44:29: consistency.spacing Inconsistent spacing after period (1 vs. 2 spaces).
./core/messenger.md:111:61: garner.phrasal_adjectives.ly No hyphen is necessary in phrasal adjectives with an adverb ending in -ly, unless the -ly adverb is part of a longer phrase

First one is completely fine to the best of my knowledge, or the removal of fully-featured might work as an alternative?

Second is the whitespace in the dns section, I do not know enough about DNS records and their creation to know if the removal of a single whitespace to appease a prose linter would still make the guide still work, so I have not touched it.

Third is a link to symfony docs, where the it's the section title which would need "fixing", but this is a url, should a prose tool be reading URLs - maybe they will stop validating URLs over this.

Addition: With respect to the third, we might want to switch to a different tool than Proselint given the lack of updates.

Copy link
Member

@dunglas dunglas left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry for the late review. Could you also rebase please?

@@ -559,7 +559,7 @@ $list->insert($itemNormalizer, -895);
// $list->insert($uuidDenormalizer, -895); //Todo ramsey uuid support ?
$list->insert($openApiNormalizer, -780);

// TODO: JSON-API support
// Todo: JSON-API support
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you revert this one please? This syntax in "normal"

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Happy to do so, and I wholly agree this is normal syntax, just proselint doesn't agree, removed the commit entirely + rebased.

```lint
./extra/releases.md: - dates_times.dates When specifying a month and year, no comma is needed.
```
```lint
weasel_words.very Substitute 'damn' every time you're inclined to write 'very'; your editor will delete it and the writing will be just as it should be.
```
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.

2 participants