From 8a4945db28a6771992346e9d3ddc4e11c441e5fc Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Sat, 31 May 2025 11:48:07 -0700 Subject: [PATCH] Fix some spelling issues, replace lorem ipsum with generated prose --- .cspell.json | 1 + site/src/assets/examples/blog/index.astro | 4 +- site/src/content/docs/content/prose.mdx | 54 +++++++++---------- site/src/content/docs/customize/color.mdx | 2 +- .../src/content/docs/utilities/background.mdx | 2 +- site/src/content/docs/utilities/display.mdx | 2 +- 6 files changed, 33 insertions(+), 32 deletions(-) diff --git a/.cspell.json b/.cspell.json index d2434c30a6..191c9bc05c 100644 --- a/.cspell.json +++ b/.cspell.json @@ -29,6 +29,7 @@ "Crossfade", "crossfading", "cssgrid", + "csstricks", "Csvg", "Datalists", "Deque", diff --git a/site/src/assets/examples/blog/index.astro b/site/src/assets/examples/blog/index.astro index 35894b5286..f30cda19be 100644 --- a/site/src/assets/examples/blog/index.astro +++ b/site/src/assets/examples/blog/index.astro @@ -174,8 +174,8 @@ import Placeholder from "@shortcodes/Placeholder.astro" Name - Upvotes - Downvotes + Up-votes + Down-votes diff --git a/site/src/content/docs/content/prose.mdx b/site/src/content/docs/content/prose.mdx index d7019432a3..0eaa383989 100644 --- a/site/src/content/docs/content/prose.mdx +++ b/site/src/content/docs/content/prose.mdx @@ -19,12 +19,12 @@ Wrap your content in the `.prose` class to get modified font-size, line-height, This is an example of source Markdown that shows several types of HTML content supported in this `.prose` wrapper class.
-# Lorem ipsum dolor sit amet -Cum sociis natoque penatibus et magnis [dis parturient montes](#), nascetur ridiculus mus. *Aenean eu leo quam.* Pellentesque ornare sem lacinia quam venenatis vestibulum. Sed posuere consectetur est at lobortis. Cras mattis consectetur purus sit amet fermentum. +# Getting Started with Documentation +Writing clear and effective documentation is essential for any project. When you create content that others will read and use, [proper formatting](#) makes all the difference. *Good documentation* helps users understand complex concepts quickly and efficiently. -> Curabitur blandit tempus porttitor. Nullam quis risus eget urna mollis ornare vel eu leo. Nullam id dolor id nibh ultricies vehicula ut id elit. +> Documentation is a love letter that you write to your future self. Clear writing today saves countless hours of confusion tomorrow. -Etiam porta **sem malesuada magna** mollis euismod. Cras mattis consectetur purus sit amet fermentum. Aenean lacinia bibendum nulla sed consectetur. +The foundation of great documentation starts with **understanding your audience** and their needs. Writers should focus on clarity, consistency, and providing practical examples that readers can follow. ## Inline HTML elements @@ -42,7 +42,7 @@ Most of these elements are styled by browsers with few modifications on our part ## Heading -Vivamus sagittis lacus vel augue rutrum faucibus dolor auctor. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Morbi leo risus, porta ac consectetur ac, vestibulum at eros. +Effective documentation requires careful attention to structure and flow. When organizing content, consider how readers will navigate through your material and what information they need first. Clear headings help users scan quickly and find relevant sections. ### Code @@ -59,32 +59,32 @@ adder(2, 6); // > 8 ``` -Aenean lacinia bibendum nulla sed consectetur. Etiam porta sem malesuada magna mollis euismod. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa. +Code examples should be practical and directly related to the concepts being explained. Always test your code snippets to ensure they work as expected before including them in documentation. ### Lists -Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Aenean lacinia bibendum nulla sed consectetur. Etiam porta sem malesuada magna mollis euismod. Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus. +When presenting information in lists, consider whether the order matters. Use numbered lists for sequential steps and bullet points for related items that don't require a specific order. -- Praesent commodo cursus magna, vel scelerisque nisl consectetur et. -- Donec id elit non mi porta gravida at eget metus. -- Nulla vitae elit libero, a pharetra augue. +- Write clear, concise list items that focus on one concept each. +- Use parallel structure across all items in your list. +- Keep list items roughly the same length when possible. -Donec ullamcorper nulla non metus auctor fringilla. Nulla vitae elit libero, a pharetra augue. +Consistency in formatting helps readers process information more efficiently. -1. Vestibulum id ligula porta felis euismod semper. -2. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. -3. Maecenas sed diam eget risus varius blandit sit amet non magna. +1. Start with the most important information first. +2. Provide context before diving into technical details. +3. Include practical examples that readers can apply immediately. -Cras mattis consectetur purus sit amet fermentum. Sed posuere consectetur est at lobortis. +Well-structured content makes complex topics more accessible to readers with varying levels of expertise. -- Praesent commodo cursus magna, vel scelerisque nisl consectetur et. - - Praesent commodo cursus magna, vel scelerisque nisl consectetur et. - - Donec id elit non mi porta gravida at eget metus. - - Nulla vitae elit libero, a pharetra augue. -- Donec id elit non mi porta gravida at eget metus. -- Nulla vitae elit libero, a pharetra augue. +- Document your processes and decisions for future reference. + - Include reasoning behind important choices you made. + - Note any alternative approaches you considered. + - Record lessons learned during implementation. +- Update documentation regularly as your project evolves. +- Test documentation with actual users to identify gaps. -Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut fermentum massa justo sit amet risus. +Regular maintenance ensures your documentation remains accurate and helpful over time.
HyperText Markup Language (HTML)
@@ -97,11 +97,11 @@ Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut ferm
The programming language used to build advanced Web sites and applications
-Integer posuere erat a ante venenatis dapibus posuere velit aliquet. Morbi leo risus, porta ac consectetur ac, vestibulum at eros. Nullam quis risus eget urna mollis ornare vel eu leo. +Technical definitions should be clear and accessible to your target audience. Avoid jargon when simpler terms will convey the same meaning effectively. ### Images -Quisque consequat sapien eget quam rhoncus, sit amet laoreet diam tempus. Aliquam aliquam metus erat, a pulvinar turpis suscipit at. +Visual elements enhance understanding by providing concrete examples of abstract concepts. Choose images that directly support your written content rather than serving as mere decoration. ![placeholder](http://placehold.it/800x400 "Large example image") ![placeholder](http://placehold.it/400x200 "Medium example image") @@ -109,15 +109,15 @@ Quisque consequat sapien eget quam rhoncus, sit amet laoreet diam tempus. Aliqua ### Tables -Aenean lacinia bibendum nulla sed consectetur. Lorem ipsum dolor sit amet, consectetur adipiscing elit. +Tables work best for comparing related data points or presenting structured information that benefits from a grid layout. -| Name | Upvotes | Downvotes | +| Name | Up-votes | Down-votes | |---------|---------|-----------| | Alice | 10 | 11 | | Bob | 4 | 3 | | Charlie | 7 | 9 | | Totals | 21 | 23 | -Nullam id dolor id nibh ultricies vehicula ut id elit. Sed posuere consectetur est at lobortis. Nullam quis risus eget urna mollis ornare vel eu leo. +Keep table headers descriptive and consider the reading order when arranging columns. Simple tables are easier to understand and maintain than complex ones.
diff --git a/site/src/content/docs/customize/color.mdx b/site/src/content/docs/customize/color.mdx index de061012ae..31fd827cd1 100644 --- a/site/src/content/docs/customize/color.mdx +++ b/site/src/content/docs/customize/color.mdx @@ -118,7 +118,7 @@ Here's a little guidance on pairing the background and border colors together. E
.bg.border-muted
.bg.border-subtle
`} /> -For other situations, where you have a tinted background color like `.bg-1`, `.bg-2`, or `.bg-3`, consider using the emphsized border variant to maintiain a little contrast between the background and border. +For other situations, where you have a tinted background color like `.bg-1`, `.bg-2`, or `.bg-3`, consider using the emphasized border variant to maintain a little contrast between the background and border. .bg-1.border
.bg-2.border-emphasized
diff --git a/site/src/content/docs/utilities/background.mdx b/site/src/content/docs/utilities/background.mdx index 504d9db711..8cca6266fa 100644 --- a/site/src/content/docs/utilities/background.mdx +++ b/site/src/content/docs/utilities/background.mdx @@ -46,7 +46,7 @@ Set the `background-color` of an element. - We generate an attribute utility for classes that include `.bg-`, which looks like `[class*="bg-"]`, and set `background-color: var(--bs-bg)`. - Then, our specific color utilities set the `--bs-bg` CSS variable to the color value. - Background utilities don't set `color`, so you may need to use `.text-` or `.text-on-*` [color utilities]([[docsref:/utilities/colors]]). -- Lastly, most background color utilities are responsive to color mode changes. This excludes inherit and transapent as there's no need, plus white and black as these exist for ease of common translucent colors. +- Lastly, most background color utilities are responsive to color mode changes. This excludes inherit and transparent as there's no need, plus white and black as these exist for ease of common translucent colors. Here are the available background color utilities: diff --git a/site/src/content/docs/utilities/display.mdx b/site/src/content/docs/utilities/display.mdx index 87c24caf9a..3ac29d1e97 100644 --- a/site/src/content/docs/utilities/display.mdx +++ b/site/src/content/docs/utilities/display.mdx @@ -39,7 +39,7 @@ The media queries affect screen widths with the given breakpoint *or larger*. Fo ## Clearfix -We've removed the clearfix helper class in v6 as it's outdated and no longer needed. Insated, use the `display: flow-root` utility, `.d-flow-root`. This forces a container element to create a new block formatting context without the clearfix hack. +We've removed the clearfix helper class in v6 as it's outdated and no longer needed. Instead, use the `display: flow-root` utility, `.d-flow-root`. This forces a container element to create a new block formatting context without the clearfix hack.
Floated element