diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md index 9d9922f25f4d7f4f3250886c9eb6d90b4eb9d034..963db62fe3fb973cbcbc48abcc8117590bcc4dd6 100644 --- a/CODE_OF_CONDUCT.md +++ b/CODE_OF_CONDUCT.md @@ -8,19 +8,19 @@ In the interest of fostering an open and welcoming environment, we as contributo Examples of behavior that contributes to creating a positive environment include: -* Using welcoming and inclusive language -* Being respectful of differing viewpoints and experiences -* Gracefully accepting constructive criticism -* Focusing on what is best for the community -* Showing empathy towards other community members +- Using welcoming and inclusive language +- Being respectful of differing viewpoints and experiences +- Gracefully accepting constructive criticism +- Focusing on what is best for the community +- Showing empathy towards other community members Examples of unacceptable behavior by participants include: -* The use of sexualized language or imagery and unwelcome sexual attention or advances -* Trolling, insulting/derogatory comments, and personal or political attacks -* Public or private harassment -* Publishing others' private information, such as a physical or electronic address, without explicit permission -* Other conduct which could reasonably be considered inappropriate in a professional setting +- The use of sexualized language or imagery and unwelcome sexual attention or advances +- Trolling, insulting/derogatory comments, and personal or political attacks +- Public or private harassment +- Publishing others' private information, such as a physical or electronic address, without explicit permission +- Other conduct which could reasonably be considered inappropriate in a professional setting ## Our Responsibilities diff --git a/README.md b/README.md index 7ef4ca9aabb278bbb7e884855769b71da54b343f..7d8081a2dd24085b958b11e63523c9dd0eea5418 100644 --- a/README.md +++ b/README.md @@ -193,16 +193,16 @@ Thanks to [BrowserStack](https://www.browserstack.com/) for providing the infras Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/bootstrap#sponsor)] -[](https://opencollective.com/bootstrap/sponsor/0/website) -[](https://opencollective.com/bootstrap/sponsor/1/website) -[](https://opencollective.com/bootstrap/sponsor/2/website) -[](https://opencollective.com/bootstrap/sponsor/3/website) -[](https://opencollective.com/bootstrap/sponsor/4/website) -[](https://opencollective.com/bootstrap/sponsor/5/website) -[](https://opencollective.com/bootstrap/sponsor/6/website) -[](https://opencollective.com/bootstrap/sponsor/7/website) -[](https://opencollective.com/bootstrap/sponsor/8/website) -[](https://opencollective.com/bootstrap/sponsor/9/website) +[](https://opencollective.com/bootstrap/sponsor/0/website) +[](https://opencollective.com/bootstrap/sponsor/1/website) +[](https://opencollective.com/bootstrap/sponsor/2/website) +[](https://opencollective.com/bootstrap/sponsor/3/website) +[](https://opencollective.com/bootstrap/sponsor/4/website) +[](https://opencollective.com/bootstrap/sponsor/5/website) +[](https://opencollective.com/bootstrap/sponsor/6/website) +[](https://opencollective.com/bootstrap/sponsor/7/website) +[](https://opencollective.com/bootstrap/sponsor/8/website) +[](https://opencollective.com/bootstrap/sponsor/9/website) ## Backers diff --git a/js/tests/README.md b/js/tests/README.md index 41fddb9a3118523b758dd7295370cc270bb1c8fc..1e2b5d868887cc2d3b8ddb316455de15e010f2f9 100644 --- a/js/tests/README.md +++ b/js/tests/README.md @@ -2,7 +2,7 @@ Bootstrap uses [Jasmine](https://jasmine.github.io/). Each plugin has a file dedicated to its tests in `tests/unit/<plugin-name>.spec.js`. -* `visual/` contains "visual" tests which are run interactively in real browsers and require manual verification by humans. +- `visual/` contains "visual" tests which are run interactively in real browsers and require manual verification by humans. To run the unit test suite via [Karma](https://karma-runner.github.io/), run `npm run js-test`. To run the unit test suite via [Karma](https://karma-runner.github.io/) and debug, run `npm run js-debug`. @@ -18,11 +18,11 @@ To run the unit test suite via [Karma](https://karma-runner.github.io/) and debu ## What should a unit test look like? -* Each test should have a unique name clearly stating what unit is being tested. -* Each test should be in the corresponding `describe`. -* Each test should test only one unit per test, although one test can include several assertions. Create multiple tests for multiple units of functionality. -* Each test should use [`expect`](https://jasmine.github.io/api/edge/matchers.html) to ensure something is expected. -* Each test should follow the project's [JavaScript Code Guidelines](https://github.com/twbs/bootstrap/blob/master/CONTRIBUTING.md#js) +- Each test should have a unique name clearly stating what unit is being tested. +- Each test should be in the corresponding `describe`. +- Each test should test only one unit per test, although one test can include several assertions. Create multiple tests for multiple units of functionality. +- Each test should use [`expect`](https://jasmine.github.io/api/edge/matchers.html) to ensure something is expected. +- Each test should follow the project's [JavaScript Code Guidelines](https://github.com/twbs/bootstrap/blob/master/CONTRIBUTING.md#js) ## Code coverage diff --git a/site/content/docs/5.0/about/license.md b/site/content/docs/5.0/about/license.md index a18fe0f601f28e972e97fff5f95292511f92c5bb..07e60e00aab414987199821ab55f7a413b8005d3 100644 --- a/site/content/docs/5.0/about/license.md +++ b/site/content/docs/5.0/about/license.md @@ -9,7 +9,7 @@ Bootstrap is released under the MIT license and is copyright {{< year >}} Twitte ## It requires you to: -* Keep the license and copyright notice included in Bootstrap's CSS and JavaScript files when you use them in your works +- Keep the license and copyright notice included in Bootstrap's CSS and JavaScript files when you use them in your works ## It permits you to: diff --git a/site/content/docs/5.0/content/tables.md b/site/content/docs/5.0/content/tables.md index 1d5477313aa02da960c95c2943d16903876926f8..156a68e90d13d37dccc2b22800ee548553a42abf 100644 --- a/site/content/docs/5.0/content/tables.md +++ b/site/content/docs/5.0/content/tables.md @@ -399,7 +399,7 @@ Border styles, active styles, and table variants are not inherited by nested tab ## How nesting works -To prevent _any_ styles from leaking to nested tables, we use the child combinator (`>`) selector in our CSS. Since we need to target all the `td`s and `th`s in the `thead`, `tbody`, and `tfoot`, our selector would look pretty long without it. As such, we use the rather odd looking `.table > :not(caption) > * > * ` selector to target all `td`s and `th`s of the `.table`, but none of any potential nested tables. +To prevent _any_ styles from leaking to nested tables, we use the child combinator (`>`) selector in our CSS. Since we need to target all the `td`s and `th`s in the `thead`, `tbody`, and `tfoot`, our selector would look pretty long without it. As such, we use the rather odd looking `.table > :not(caption) > * > *` selector to target all `td`s and `th`s of the `.table`, but none of any potential nested tables. Note that if you add `<tr>`s as direct children of a table, those `<tr>` will be wrapped in a `<tbody>` by default, thus making our selectors work as intended. diff --git a/site/content/docs/5.0/content/typography.md b/site/content/docs/5.0/content/typography.md index 7d4875e9259ee38e14c4ed4b451ce01a65fe6a09..0bbe54c427b074ce220e44d00bacfbaef7466896 100644 --- a/site/content/docs/5.0/content/typography.md +++ b/site/content/docs/5.0/content/typography.md @@ -153,17 +153,17 @@ Styling for common inline HTML5 elements. Beware that those tags should be used for semantic purpose: -* `<mark>` represents text which is marked or highlighted for reference or notation purposes. -* `<small>` represents side-comments and small print, like copyright and legal text. -* `<s>` represents element that are no longer relevant or no longer accurate. -* `<u>` represents a span of inline text which should be rendered in a way that indicates that it has a non-textual annotation. +- `<mark>` represents text which is marked or highlighted for reference or notation purposes. +- `<small>` represents side-comments and small print, like copyright and legal text. +- `<s>` represents element that are no longer relevant or no longer accurate. +- `<u>` represents a span of inline text which should be rendered in a way that indicates that it has a non-textual annotation. If you want to style your text, you should use the following classes instead: -* `.mark` will apply the same styles as `<mark>`. -* `.small` will apply the same styles as `<small>`. -* `.text-decoration-underline` will apply the same styles as `<u>`. -* `.text-decoration-line-through` will apply the same styles as `<s>`. +- `.mark` will apply the same styles as `<mark>`. +- `.small` will apply the same styles as `<small>`. +- `.text-decoration-underline` will apply the same styles as `<u>`. +- `.text-decoration-line-through` will apply the same styles as `<s>`. While not shown above, feel free to use `<b>` and `<i>` in HTML5. `<b>` is meant to highlight words or phrases without conveying additional importance, while `<i>` is mostly for voice, technical terms, etc. diff --git a/site/content/docs/5.0/customize/optimize.md b/site/content/docs/5.0/customize/optimize.md index d5e3906e3664b0491956c7f0c5243dafd9235719..a6a306109f49039ada704609000be4cc07783922 100644 --- a/site/content/docs/5.0/customize/optimize.md +++ b/site/content/docs/5.0/customize/optimize.md @@ -43,8 +43,8 @@ _Help wanted with this section, please consider opening a PR. Thanks!_ While we don't have a prebuilt example for using [PurgeCSS](https://github.com/FullHuman/purgecss) with Bootstrap, there are some helpful articles and walkthroughs that the community has written. Here are some options: -- https://medium.com/dwarves-foundation/remove-unused-css-styles-from-bootstrap-using-purgecss-88395a2c5772 -- https://lukencode.com/2018/07/29/automatically-removeunused-css-from-bootstrap-or-other-frameworks/ +- <https://medium.com/dwarves-foundation/remove-unused-css-styles-from-bootstrap-using-purgecss-88395a2c5772> +- <https://lukencode.com/2018/07/29/automatically-removeunused-css-from-bootstrap-or-other-frameworks/> Lastly, this [CSS Tricks article on unused CSS](https://css-tricks.com/how-do-you-remove-unused-css-from-a-site/) shows how to use PurgeCSS and other similar tools. diff --git a/site/content/docs/5.0/migration.md b/site/content/docs/5.0/migration.md index 96059e31e21511a83fc0c12bd0f743884f79b404..998dd9974e73ef6f82bdfb6c002b924b9df89e5b 100644 --- a/site/content/docs/5.0/migration.md +++ b/site/content/docs/5.0/migration.md @@ -187,6 +187,6 @@ Badges were overhauled to better differentiate themselves from buttons and to be ## Docs -- Removed "Wall of browser bugs" page because it has become obsolete +- Removed "Wall of browser bugs" page because it has become obsolete ## Build tools diff --git a/site/content/docs/5.0/utilities/display.md b/site/content/docs/5.0/utilities/display.md index b80266af03bd1ab8c39dd519a2d25610e2392565..cbf41d2b3959d6544c653a38d313740ab348c41d 100644 --- a/site/content/docs/5.0/utilities/display.md +++ b/site/content/docs/5.0/utilities/display.md @@ -16,20 +16,20 @@ Display utility classes that apply to all [breakpoints]({{< docsref "/layout/bre As such, the classes are named using the format: -* `.d-{value}` for `xs` -* `.d-{breakpoint}-{value}` for `sm`, `md`, `lg`, `xl`, and `xxl`. +- `.d-{value}` for `xs` +- `.d-{breakpoint}-{value}` for `sm`, `md`, `lg`, `xl`, and `xxl`. Where *value* is one of: -* `none` -* `inline` -* `inline-block` -* `block` -* `table` -* `table-cell` -* `table-row` -* `flex` -* `inline-flex` +- `none` +- `inline` +- `inline-block` +- `block` +- `table` +- `table-cell` +- `table-row` +- `flex` +- `inline-flex` The display values can be altered by changing the `$displays` variable and recompiling the SCSS. diff --git a/site/content/docs/5.0/utilities/spacing.md b/site/content/docs/5.0/utilities/spacing.md index ce32ad499f7b65949dfcc9ed27b268f20a276abe..e7a2960877c4f568c0f0a52c6785a5bda676fde1 100644 --- a/site/content/docs/5.0/utilities/spacing.md +++ b/site/content/docs/5.0/utilities/spacing.md @@ -18,28 +18,28 @@ The classes are named using the format `{property}{sides}-{size}` for `xs` and ` Where *property* is one of: -* `m` - for classes that set `margin` -* `p` - for classes that set `padding` +- `m` - for classes that set `margin` +- `p` - for classes that set `padding` Where *sides* is one of: -* `t` - for classes that set `margin-top` or `padding-top` -* `b` - for classes that set `margin-bottom` or `padding-bottom` -* `l` - for classes that set `margin-left` or `padding-left` -* `r` - for classes that set `margin-right` or `padding-right` -* `x` - for classes that set both `*-left` and `*-right` -* `y` - for classes that set both `*-top` and `*-bottom` -* blank - for classes that set a `margin` or `padding` on all 4 sides of the element +- `t` - for classes that set `margin-top` or `padding-top` +- `b` - for classes that set `margin-bottom` or `padding-bottom` +- `l` - for classes that set `margin-left` or `padding-left` +- `r` - for classes that set `margin-right` or `padding-right` +- `x` - for classes that set both `*-left` and `*-right` +- `y` - for classes that set both `*-top` and `*-bottom` +- blank - for classes that set a `margin` or `padding` on all 4 sides of the element Where *size* is one of: -* `0` - for classes that eliminate the `margin` or `padding` by setting it to `0` -* `1` - (by default) for classes that set the `margin` or `padding` to `$spacer * .25` -* `2` - (by default) for classes that set the `margin` or `padding` to `$spacer * .5` -* `3` - (by default) for classes that set the `margin` or `padding` to `$spacer` -* `4` - (by default) for classes that set the `margin` or `padding` to `$spacer * 1.5` -* `5` - (by default) for classes that set the `margin` or `padding` to `$spacer * 3` -* `auto` - for classes that set the `margin` to auto +- `0` - for classes that eliminate the `margin` or `padding` by setting it to `0` +- `1` - (by default) for classes that set the `margin` or `padding` to `$spacer * .25` +- `2` - (by default) for classes that set the `margin` or `padding` to `$spacer * .5` +- `3` - (by default) for classes that set the `margin` or `padding` to `$spacer` +- `4` - (by default) for classes that set the `margin` or `padding` to `$spacer * 1.5` +- `5` - (by default) for classes that set the `margin` or `padding` to `$spacer * 3` +- `auto` - for classes that set the `margin` to auto (You can add more sizes by adding entries to the `$spacers` Sass map variable.)