Commit 6251dc5
authored
style: give buttons a clear hierarchy and mark external links (#50)
## What
On the Getting Started page, every call-to-action button was rendered as
a filled **primary** button. When everything is primary, nothing is —
the eye has no anchor and the page reads as a wall of equally-weighted
blue buttons.
This PR introduces a visual hierarchy and distinguishes links that leave
the docs site.
### Button hierarchy
Keep the filled `.md-button--primary` style on just **two** buttons —
the recommended entry point in each of the two decision areas:
- **GitHub Actions** — the recommended integration in *Choose Your
Integration*
- **clang-tools-pip** — the recommended installer in *Install the clang
tools*
Every other button is demoted to the outlined `.md-button` style, so
each section now has one obvious primary action and a set of
clearly-secondary alternatives.
### External-link marking
Buttons that navigate away from the docs site (to `github.com` /
`pypi.org`) now end with an external-link icon
(`:octicons-link-external-16:`) instead of the `→` arrow. The two
in-ecosystem `cpp-linter.github.io` links keep the `→`, signalling
"you're staying on the docs site."
## Why
- Clearer guidance: a first-time visitor is steered toward the two
recommended paths instead of facing a dozen equal choices.
- Honest affordances: users know before clicking whether a button keeps
them on the docs or sends them to GitHub/PyPI.
## Notes
Content, links, and card structure are unchanged — this is purely a
styling/affordance pass.
---
_Generated by [Claude
Code](https://claude.ai/code/session_012uXrN1wk5EaqK5GimN3deT)_1 parent 07c8a1b commit 6251dc5
1 file changed
Lines changed: 10 additions & 10 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
44 | 44 | | |
45 | 45 | | |
46 | 46 | | |
47 | | - | |
| 47 | + | |
48 | 48 | | |
49 | 49 | | |
50 | 50 | | |
| |||
54 | 54 | | |
55 | 55 | | |
56 | 56 | | |
57 | | - | |
| 57 | + | |
58 | 58 | | |
59 | 59 | | |
60 | 60 | | |
| |||
64 | 64 | | |
65 | 65 | | |
66 | 66 | | |
67 | | - | |
| 67 | + | |
68 | 68 | | |
69 | 69 | | |
70 | 70 | | |
| |||
91 | 91 | | |
92 | 92 | | |
93 | 93 | | |
94 | | - | |
| 94 | + | |
95 | 95 | | |
96 | 96 | | |
97 | 97 | | |
98 | 98 | | |
99 | 99 | | |
100 | 100 | | |
101 | 101 | | |
102 | | - | |
| 102 | + | |
103 | 103 | | |
104 | 104 | | |
105 | 105 | | |
| |||
113 | 113 | | |
114 | 114 | | |
115 | 115 | | |
116 | | - | |
| 116 | + | |
117 | 117 | | |
118 | 118 | | |
119 | 119 | | |
120 | 120 | | |
121 | 121 | | |
122 | 122 | | |
123 | 123 | | |
124 | | - | |
| 124 | + | |
125 | 125 | | |
126 | 126 | | |
127 | 127 | | |
128 | 128 | | |
129 | 129 | | |
130 | 130 | | |
131 | 131 | | |
132 | | - | |
| 132 | + | |
133 | 133 | | |
134 | 134 | | |
135 | 135 | | |
| |||
143 | 143 | | |
144 | 144 | | |
145 | 145 | | |
146 | | - | |
| 146 | + | |
147 | 147 | | |
148 | 148 | | |
149 | 149 | | |
150 | 150 | | |
151 | 151 | | |
152 | 152 | | |
153 | 153 | | |
154 | | - | |
| 154 | + | |
155 | 155 | | |
156 | 156 | | |
0 commit comments