]> git.ipfire.org Git - thirdparty/bootstrap.git/commitdiff
Fix some spelling issues, replace lorem ipsum with generated prose
authorMark Otto <markdotto@gmail.com>
Sat, 31 May 2025 18:48:07 +0000 (11:48 -0700)
committerMark Otto <markdotto@gmail.com>
Sat, 31 May 2025 18:48:07 +0000 (11:48 -0700)
.cspell.json
site/src/assets/examples/blog/index.astro
site/src/content/docs/content/prose.mdx
site/src/content/docs/customize/color.mdx
site/src/content/docs/utilities/background.mdx
site/src/content/docs/utilities/display.mdx

index d2434c30a608edff93cca527ab97cba2b73b491d..191c9bc05c2ff88e6dda15e74e0052572723b8ec 100644 (file)
@@ -29,6 +29,7 @@
     "Crossfade",
     "crossfading",
     "cssgrid",
+    "csstricks",
     "Csvg",
     "Datalists",
     "Deque",
index 35894b528638cd295a91b5d5e92f7e48d9fed898..f30cda19beb3fef0162dc364c3a838ecf9c936c2 100644 (file)
@@ -174,8 +174,8 @@ import Placeholder from "@shortcodes/Placeholder.astro"
           <thead>
             <tr>
               <th>Name</th>
-              <th>Upvotes</th>
-              <th>Downvotes</th>
+              <th>Up-votes</th>
+              <th>Down-votes</th>
             </tr>
           </thead>
           <tbody>
index d7019432a3eb0b5f38448e7dada7b7ac66e4cff9..0eaa383989965b6e91f86aae409ee2c71f67d1af 100644 (file)
@@ -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.
 
 <div class="bd-example prose">
-# 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.
 
 <dl>
   <dt>HyperText Markup Language (HTML)</dt>
@@ -97,11 +97,11 @@ Fusce dapibus, tellus ac cursus commodo, tortor mauris condimentum nibh, ut ferm
   <dd>The programming language used to build advanced Web sites and applications</dd>
 </dl>
 
-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.
 
 </div>
index de061012ae6e6c0c0686d54342193120497b3ba2..31fd827cd11deda45c01a684e6be175d5823b49d 100644 (file)
@@ -118,7 +118,7 @@ Here's a little guidance on pairing the background and border colors together. E
 <div class="p-3 mb-3 bg" style="border: 1px solid var(--bs-border-muted)">.bg.border-muted</div>
 <div class="p-3 mb-3 bg" style="border: 1px solid var(--bs-border-subtle)">.bg.border-subtle</div>`} />
 
-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.
 
 <Example code={`<div class="p-3 mb-3 bg-1" style="border: 1px solid var(--bs-border)">.bg-1.border</div>
 <div class="p-3 mb-3 bg-2" style="border: 1px solid var(--bs-border-emphasized)">.bg-2.border-emphasized</div>
index 504d9db7110d0ac2af9ecd3dedb7bb8590bd7aa6..8cca6266faaf3b11061a114aca50bcf9f6fe6916 100644 (file)
@@ -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:
 
index 87c24caf9a974dc2aca748556e71c7f428658240..3ac29d1e9712451dbb93ecf7f475ecdfc2b72f31 100644 (file)
@@ -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.
 
 <Example code={`<div class="d-flow-root">
   <div class="float-end px-3 py-2 border rounded-3">Floated element</div>