Skip to content

docs: standardize bullet style to hyphens (GH9742)#9937

Open
gulsahsarsilmaz wants to merge 1 commit intowarpdotdev:masterfrom
gulsahsarsilmaz:gulsah/gh9742-standardize-markdown
Open

docs: standardize bullet style to hyphens (GH9742)#9937
gulsahsarsilmaz wants to merge 1 commit intowarpdotdev:masterfrom
gulsahsarsilmaz:gulsah/gh9742-standardize-markdown

Conversation

@gulsahsarsilmaz
Copy link
Copy Markdown
Contributor

Summary

Resolves the inconsistent bullet styling called out in #9742. Two files in the core docs were mixing asterisk (*) and hyphen
(-) bullets within themselves, while every other top-level Markdown file in the repo already uses hyphens uniformly:

  • README.md — the nine Open Source Dependencies entries used * while the rest of the file used -.
  • .github/pull_request_template.md — the five CHANGELOG-* suffix descriptions in the commented-out instruction block used
    * while the visible Linked Issue checkboxes used -.

Both are now hyphens. After this PR every .md file in the seven core docs (CODE_OF_CONDUCT.md, CONTRIBUTING.md, FAQ.md,
README.md, SECURITY.md, WARP.md, .github/pull_request_template.md) uses the hyphen style consistently.

The other items mentioned in #9742 (header spacing, section dividers) were spot-checked and are already consistent across these
files; no further changes were necessary. If a maintainer wants stricter project-wide enforcement (e.g. a markdownlint config or
prettier --parser markdown run over the whole tree), that is a tooling decision that warrants its own discussion and a much
larger diff — happy to follow up on a separate PR if there is interest.

Linked Issue

Closes #9742.

  • The linked issue is labeled ready-to-spec or ready-to-implement.
  • Where appropriate, screenshots or a short video of the implementation are included below (especially for user-visible or UI
    changes).

N/A — docs-only change; no UI or behavior impact.

Screenshots / Videos

N/A — docs-only.

Testing

Verified post-edit with grep -c '^\* \|^ \* \|^ \* ' over the seven core .md files; all return 0 asterisk-bulleted lines.
No code changes; no test-suite impact.

Agent Mode

  • Warp Agent Mode - This PR was created via Warp's AI Agent Mode

Two files mixed asterisk and hyphen bullets:

- README.md: 9 asterisk-bulleted dependency links in
  "Open Source Dependencies" alongside hyphen bullets elsewhere in
  the same file.
- .github/pull_request_template.md: 5 asterisk-bulleted changelog
  suffix descriptions in the commented-out instructions, alongside
  hyphen bullets used in the visible Linked Issue checkboxes.

Convert both to hyphens so every Markdown file in the repo's core
docs (CODE_OF_CONDUCT.md, CONTRIBUTING.md, FAQ.md, README.md,
SECURITY.md, WARP.md, .github/pull_request_template.md) uses the
hyphen bullet style consistently. No content or wording changes.

Verified post-edit: zero asterisk bullets remain in the seven core
docs files; all bullets are hyphens.
@cla-bot cla-bot Bot added the cla-signed label May 2, 2026
@github-actions github-actions Bot added the external-contributor Indicates that a PR has been opened by someone outside the Warp team. label May 2, 2026
@oz-for-oss
Copy link
Copy Markdown
Contributor

oz-for-oss Bot commented May 2, 2026

@gulsahsarsilmaz

I'm starting a first review of this pull request.

You can view the conversation on Warp.

I reviewed this pull request and requested human review from: @warpdotdev/oss-maintainers.

Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

Copy link
Copy Markdown
Contributor

@oz-for-oss oz-for-oss Bot left a comment

Choose a reason for hiding this comment

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

Overview

This docs-only PR standardizes Markdown bullet markers from asterisks to hyphens in .github/pull_request_template.md and README.md without changing rendered content or repository behavior.

Concerns

  • No blocking concerns found.

Verdict

Found: 0 critical, 0 important, 0 suggestions

Approve

Comment /oz-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

@oz-for-oss oz-for-oss Bot requested review from a team and kevinchevalier and removed request for a team May 2, 2026 20:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cla-signed external-contributor Indicates that a PR has been opened by someone outside the Warp team.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs: Standardize All Markdown formatting across core files and specs

1 participant