mirror of https://github.com/twbs/bootstrap.git
Fix some spelling issues, replace lorem ipsum with generated prose
This commit is contained in:
parent
5c3aa0e9f4
commit
8a4945db28
|
@ -29,6 +29,7 @@
|
||||||
"Crossfade",
|
"Crossfade",
|
||||||
"crossfading",
|
"crossfading",
|
||||||
"cssgrid",
|
"cssgrid",
|
||||||
|
"csstricks",
|
||||||
"Csvg",
|
"Csvg",
|
||||||
"Datalists",
|
"Datalists",
|
||||||
"Deque",
|
"Deque",
|
||||||
|
|
|
@ -174,8 +174,8 @@ import Placeholder from "@shortcodes/Placeholder.astro"
|
||||||
<thead>
|
<thead>
|
||||||
<tr>
|
<tr>
|
||||||
<th>Name</th>
|
<th>Name</th>
|
||||||
<th>Upvotes</th>
|
<th>Up-votes</th>
|
||||||
<th>Downvotes</th>
|
<th>Down-votes</th>
|
||||||
</tr>
|
</tr>
|
||||||
</thead>
|
</thead>
|
||||||
<tbody>
|
<tbody>
|
||||||
|
|
|
@ -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.
|
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">
|
<div class="bd-example prose">
|
||||||
# Lorem ipsum dolor sit amet
|
# Getting Started with Documentation
|
||||||
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.
|
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
|
## Inline HTML elements
|
||||||
|
|
||||||
|
@ -42,7 +42,7 @@ Most of these elements are styled by browsers with few modifications on our part
|
||||||
|
|
||||||
## Heading
|
## 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
|
### Code
|
||||||
|
|
||||||
|
@ -59,32 +59,32 @@ adder(2, 6);
|
||||||
// > 8
|
// > 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
|
### 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.
|
- Write clear, concise list items that focus on one concept each.
|
||||||
- Donec id elit non mi porta gravida at eget metus.
|
- Use parallel structure across all items in your list.
|
||||||
- Nulla vitae elit libero, a pharetra augue.
|
- 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.
|
1. Start with the most important information first.
|
||||||
2. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus.
|
2. Provide context before diving into technical details.
|
||||||
3. Maecenas sed diam eget risus varius blandit sit amet non magna.
|
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.
|
- Document your processes and decisions for future reference.
|
||||||
- Praesent commodo cursus magna, vel scelerisque nisl consectetur et.
|
- Include reasoning behind important choices you made.
|
||||||
- Donec id elit non mi porta gravida at eget metus.
|
- Note any alternative approaches you considered.
|
||||||
- Nulla vitae elit libero, a pharetra augue.
|
- Record lessons learned during implementation.
|
||||||
- Donec id elit non mi porta gravida at eget metus.
|
- Update documentation regularly as your project evolves.
|
||||||
- Nulla vitae elit libero, a pharetra augue.
|
- 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>
|
<dl>
|
||||||
<dt>HyperText Markup Language (HTML)</dt>
|
<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>
|
<dd>The programming language used to build advanced Web sites and applications</dd>
|
||||||
</dl>
|
</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
|
### 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.
|
||||||
|
|
||||||

|

|
||||||

|

|
||||||
|
@ -109,15 +109,15 @@ Quisque consequat sapien eget quam rhoncus, sit amet laoreet diam tempus. Aliqua
|
||||||
|
|
||||||
### Tables
|
### 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 |
|
| Alice | 10 | 11 |
|
||||||
| Bob | 4 | 3 |
|
| Bob | 4 | 3 |
|
||||||
| Charlie | 7 | 9 |
|
| Charlie | 7 | 9 |
|
||||||
| Totals | 21 | 23 |
|
| 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>
|
</div>
|
||||||
|
|
|
@ -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-muted)">.bg.border-muted</div>
|
||||||
<div class="p-3 mb-3 bg" style="border: 1px solid var(--bs-border-subtle)">.bg.border-subtle</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>
|
<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>
|
<div class="p-3 mb-3 bg-2" style="border: 1px solid var(--bs-border-emphasized)">.bg-2.border-emphasized</div>
|
||||||
|
|
|
@ -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)`.
|
- 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.
|
- 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]]).
|
- 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:
|
Here are the available background color utilities:
|
||||||
|
|
||||||
|
|
|
@ -39,7 +39,7 @@ The media queries affect screen widths with the given breakpoint *or larger*. Fo
|
||||||
|
|
||||||
## Clearfix
|
## 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">
|
<Example code={`<div class="d-flow-root">
|
||||||
<div class="float-end px-3 py-2 border rounded-3">Floated element</div>
|
<div class="float-end px-3 py-2 border rounded-3">Floated element</div>
|
||||||
|
|
Loading…
Reference in New Issue