Skip to content

docs: add styleguide content guidelines and align docs content#2615

Open
Lisa18289 wants to merge 7 commits into
mainfrom
2570-add-writing-style-guide-guidelines-readme-to-github
Open

docs: add styleguide content guidelines and align docs content#2615
Lisa18289 wants to merge 7 commits into
mainfrom
2570-add-writing-style-guide-guidelines-readme-to-github

Conversation

@Lisa18289

Copy link
Copy Markdown
Member

No description provided.

@Lisa18289 Lisa18289 self-assigned this Jul 7, 2026
@Lisa18289 Lisa18289 linked an issue Jul 7, 2026 that may be closed by this pull request
@Lisa18289 Lisa18289 enabled auto-merge (squash) July 7, 2026 05:27
@github-actions

github-actions Bot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

Coverage Report for ./packages/components/

Status Category Percentage Covered / Total
🔵 Lines 82.77% 298 / 360
🔵 Statements 83.06% 304 / 366
🔵 Functions 88.6% 70 / 79
🔵 Branches 72.25% 138 / 191
File CoverageNo changed files found.
Generated in workflow #5558 for commit 1034014 by the Vitest Coverage Report Action

@github-actions

github-actions Bot commented Jul 7, 2026

Copy link
Copy Markdown
Contributor

🚀 Preview Deployment

Preview environments are ready:

Type URL
docs pr-2615.docs.review.flow-components.de
storybook pr-2615.storybook.review.flow-components.de

Images:

  • docs: ghcr.io/mittwald/flow/docs:pr-2615
  • storybook: ghcr.io/mittwald/flow/storybook:pr-2615

@Lisa18289 Lisa18289 marked this pull request as draft July 10, 2026 05:51
auto-merge was automatically disabled July 10, 2026 05:51

Pull request was converted to draft

Lisa18289 and others added 4 commits July 10, 2026 08:08
- Overhaul apps/docs README: document content language (German), the two
  tone modes (objective descriptions, imperative instructions), heading
  rendering and page structure, real tab section structures, MDX building
  blocks, and QA steps
- Standardize headings: Behavior -> Verhalten, Writing guidelines casing
  and levels, sentence case for Responsive layout
- Write "Komponente" instead of "Component" in German prose (code,
  token names, and proper terms stay English)
- Move the CounterBadge accessibility note from Overview to Guidelines
- Reorder Button overview: States before Kombiniere mit ...
- Fix content bugs: broken navigation link, typos, bold code identifiers

Co-Authored-By: Claude Fable 5 <[email protected]>
Best practices -> Best Practices, Responsive layout -> Responsive Layout,
Quick submit -> Quick Submit, Progressively disclosed Form Controls ->
Progressively Disclosed Form Controls; document the title-case rule in
the README (German headings keep regular German orthography)

Co-Authored-By: Claude Fable 5 <[email protected]>
Add apps/docs/AGENTS.md pointing agents to the content guidelines in
apps/docs/README.md, and link it from the root AGENTS.md lookup table

Co-Authored-By: Claude Fable 5 <[email protected]>
@Lisa18289 Lisa18289 changed the title 2570 add writing style guide guidelines readme to GitHub docs: add styleguide content guidelines and align docs content Jul 10, 2026
@Lisa18289 Lisa18289 marked this pull request as ready for review July 10, 2026 06:33
@Lisa18289 Lisa18289 enabled auto-merge (squash) July 10, 2026 06:33
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.

Add Writing Style Guide Guidelines README to GitHub

1 participant