[dotext]

Changes

README.md

• Rearrange layout to match other recent AG repos for consistency
• Accidental >" typo resolved
• Update Twitter to X
• Remove visual bug with <a href showing space and underline after SVG image
• Update reporting tool link to match same as config.yml (https://link.adtidy.org/forward.html?action=report&app=home&from=github)
• Remove invalid "Our plans" link (section already removed)
• Update translation KB article link
• Minor revisions (typos, grammar, etc.) made

01-bug-report.yaml

• Include AdGuard Mail Tracking Protection filter
• Minor version numbering updates to keep it in line with recent releases
• Update reporting tool link to match same as config.yml (https://link.adtidy.org/forward.html?action=report&app=home&from=github)
• Minor revisions (typos, grammar, etc.) made

03-question.yaml

• Add required answer for using the latest version

Context

I've noticed that the README.md files are not unified in layout, need updated links and to resolve a few visual issues. The GitHub templates for Issues were also with outdated filter lists and with minor opportunities for some tweaks to bring it up to date with recent releases and fix a few things here and there.

• Update README and templates #6228 (Complete) (Current)
• Update README and templates AdguardForMac#1778 (Complete)
• Update README and templates AdGuardMiniForMac#1214 (Complete)
• Update README and templates AdguardForAndroid#6216
• Update README and templates AdguardForiOS#2554
• Update README and templates AdguardBrowserExtension#3633 (Complete)
• Update README and templates ContentBlocker#598 (Complete)
• Update README and templates AdGuardHome#8616

Since working with others on the other PRs for updating the README.md and template files, there are a few more things that should be applied to the templates for the sake of cohesion. These changes have already been applied to this existing PR, but PRs for this second revision have been made if already merged before these changes:

• Further revision to templates #6255
• Further revision to templates AdGuardMiniForMac#1233 (Complete)

Also added further repos that could use the same update treatment:

• Update README and templates CoreLibs#2107
• Update README and templates AdguardFilters#243832

[pritulaziah]

Hi! Thanks for the PR — looks good overall.

One suggestion: please keep the original straight apostrophes in the filter names (Peter Lowe's Blocklist, Fanboy's Anti-Facebook List, etc.) instead of replacing them with curly ones (’). These are the canonical filter names used in the app, in the filter lists, and in the Knowledge Base, so the straight apostrophe is the commonly accepted spelling everywhere. Changing them in the form makes the labels inconsistent with the actual filter names, and could break any future tooling that matches submitted values against them. Straight apostrophes are also perfectly valid in YAML, so there's no formatting issue to resolve.

Could you revert the apostrophe replacements in 01-bug-report.yaml? And since this PR is part of a series across the AG repos, please apply the same fix everywhere (AdguardForMac, AdGuardMiniForMac, AdguardForAndroid, AdguardForiOS, AdguardBrowserExtension, ContentBlocker, AdGuardHome) so the templates stay consistent.

[dotext]

Straight apostrophes are also perfectly valid in YAML, so there's no formatting issue to resolve.

Thank you for explaining this, I was misled by the GitHub Editor as it was displaying the filter names with the incorrect colour styling to indicate the apostrophe was going to do something to the name.

I will quickly revert those edits to the apostrophes now.

---

Edit: All done, fixed on all affected repos.

[dotext]

Thanks for working with me on this. Would anyone know the best way to get the other PRs approved and merged as well?

[pritulaziah]

Thanks! I'll do my best to get the other PRs approved and merged as well — I'll try to bring them to the attention of the relevant teams. That said, I can't make any promises about the timing, since it depends on each team's review capacity.

[dotext]

That's really kind, thank you!