From 9899396ca57edfa5af2302a5ebf70e8aa96ef94c Mon Sep 17 00:00:00 2001 From: Copilot <198982749+Copilot@users.noreply.github.com> Date: Fri, 14 Nov 2025 22:00:47 -0800 Subject: [PATCH] Remove Contents page from documentation (#41876) * Initial plan * Remove Contents page from docs and all references Co-authored-by: mdo <98681+mdo@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: mdo <98681+mdo@users.noreply.github.com> --- site/data/sidebar.yml | 1 - .../content/docs/getting-started/contents.mdx | 95 ------------------- .../content/docs/getting-started/download.mdx | 4 +- .../docs/getting-started/introduction.mdx | 4 +- 4 files changed, 4 insertions(+), 100 deletions(-) delete mode 100644 site/src/content/docs/getting-started/contents.mdx diff --git a/site/data/sidebar.yml b/site/data/sidebar.yml index ff80deb285..61e428ed7c 100644 --- a/site/data/sidebar.yml +++ b/site/data/sidebar.yml @@ -7,7 +7,6 @@ pages: - title: Introduction - title: Download - - title: Contents - title: Browsers & devices - title: JavaScript - title: Accessibility diff --git a/site/src/content/docs/getting-started/contents.mdx b/site/src/content/docs/getting-started/contents.mdx deleted file mode 100644 index 1ad5555e1d..0000000000 --- a/site/src/content/docs/getting-started/contents.mdx +++ /dev/null @@ -1,95 +0,0 @@ ---- -title: Contents -description: Discover what’s included in Bootstrap, including our compiled and source code flavors. -toc: true - -# TODO: possible to replace the tree by something like https://docs.astro.build/en/guides/content-collections/#what-are-content-collections? ---- - -## Compiled Bootstrap - -Once downloaded, unzip the compressed folder and you’ll see something like this: - -{/* NOTE: This info is intentionally duplicated in the README. Copy any changes made here over to the README too, but be sure to keep in mind to add the `dist` folder. */} - -```text -bootstrap/ -├── css/ -│ ├── bootstrap-grid.css -│ ├── bootstrap-grid.css.map -│ ├── bootstrap-grid.min.css -│ ├── bootstrap-grid.min.css.map -│ ├── bootstrap-reboot.css -│ ├── bootstrap-reboot.css.map -│ ├── bootstrap-reboot.min.css -│ ├── bootstrap-reboot.min.css.map -│ ├── bootstrap-utilities.css -│ ├── bootstrap-utilities.css.map -│ ├── bootstrap-utilities.min.css -│ ├── bootstrap-utilities.min.css.map -│ ├── bootstrap.css -│ ├── bootstrap.css.map -│ ├── bootstrap.min.css -│ └── bootstrap.min.css.map -└── js/ - ├── bootstrap.bundle.js - ├── bootstrap.bundle.js.map - ├── bootstrap.bundle.min.js - ├── bootstrap.bundle.min.js.map - ├── bootstrap.esm.js - ├── bootstrap.esm.js.map - ├── bootstrap.esm.min.js - ├── bootstrap.esm.min.js.map - ├── bootstrap.js - ├── bootstrap.js.map - ├── bootstrap.min.js - └── bootstrap.min.js.map -``` - -This is the most basic form of Bootstrap: compiled files for quick drop-in usage in nearly any web project. We provide compiled CSS and JS (`bootstrap.*`), as well as compiled and minified CSS and JS (`bootstrap.min.*`). [Source maps](https://web.dev/articles/source-maps) (`bootstrap.*.map`) are available for use with certain browsers' developer tools. Bundled JS files (`bootstrap.bundle.js` and minified `bootstrap.bundle.min.js`) include [Popper](https://popper.js.org/docs/v2/). All CSS files work for both LTR and RTL layouts thanks to logical properties—simply set `dir="rtl"` on your HTML element. - -### CSS files - -Bootstrap includes a handful of options for including some or all of our compiled CSS. - - -| CSS files | Layout | Content | Components | Utilities | -| --- | --- | --- | --- | --- | -| `bootstrap.css`
`bootstrap.min.css` | Included | Included | Included | Included | -| `bootstrap-grid.css`
`bootstrap-grid.min.css` | [Only grid system]([[docsref:/layout/grid]]) | — | — | [Only flex utilities]([[docsref:/utilities/flex]]) | -| `bootstrap-utilities.css`
`bootstrap-utilities.min.css` | — | — | — | Included | -| `bootstrap-reboot.css`
`bootstrap-reboot.min.css` | — | [Only Reboot]([[docsref:/content/reboot]]) | — | — | - - -### JS files - -Similarly, we have options for including some or all of our compiled JavaScript. - - -| JS Files | Popper | -| --- | --- | -| `bootstrap.bundle.js`
`bootstrap.bundle.min.js`
| Included | -| `bootstrap.js`
`bootstrap.min.js`
| – | - - -## Bootstrap source code - -The Bootstrap source code download includes the compiled CSS and JavaScript assets, along with source Sass, JavaScript, and documentation. More specifically, it includes the following and more: - -```text -bootstrap/ -├── dist/ -│ ├── css/ -│ └── js/ -├── site/ -│ └──content/ -│ └── docs/ -│ └── [[config:docs_version]]/ -│ └── examples/ -├── js/ -└── scss/ -``` - -The `scss/` and `js/` are the source code for our CSS and JavaScript. The `dist/` folder includes everything listed in the compiled download section above. The `site/content/docs/` folder includes the source code for our hosted documentation, including our live examples of Bootstrap usage. - -Beyond that, any other included file provides support for packages, license information, and development. diff --git a/site/src/content/docs/getting-started/download.mdx b/site/src/content/docs/getting-started/download.mdx index bc2cc8da8c..fbddc88fcf 100644 --- a/site/src/content/docs/getting-started/download.mdx +++ b/site/src/content/docs/getting-started/download.mdx @@ -8,8 +8,8 @@ toc: true Download ready-to-use compiled code for **Bootstrap v[[config:current_version]]** to easily drop into your project, which includes: -- Compiled and minified CSS bundles (see [CSS files comparison]([[docsref:/getting-started/contents#css-files]])) -- Compiled and minified JavaScript plugins (see [JS files comparison]([[docsref:/getting-started/contents#js-files]])) +- Compiled and minified CSS bundles +- Compiled and minified JavaScript plugins This doesn’t include documentation, source files, or any optional JavaScript dependencies like Popper. diff --git a/site/src/content/docs/getting-started/introduction.mdx b/site/src/content/docs/getting-started/introduction.mdx index f2d63d42d7..42a245e5d2 100644 --- a/site/src/content/docs/getting-started/introduction.mdx +++ b/site/src/content/docs/getting-started/introduction.mdx @@ -68,7 +68,7 @@ As reference, here are our primary CDN links. | JS | `[[config:cdn.js_bundle]]` | -You can also use the CDN to fetch any of our [additional builds listed in the Contents page]([[docsref:/getting-started/contents]]). +You can also use the CDN to fetch any of our additional builds. When using CDN links, be sure to use the `integrity` attribute to verify the correct files and versions. These hashes are unique to each file and version of Bootstrap, so when you update to a new version, be sure the `integrity` attribute is also updated. @@ -77,7 +77,7 @@ We also include a `crossorigin="anonymous"` attribute to prevent [CORS](https:// ## Next steps - Read a bit more about some [important global environment settings](#important-globals) that Bootstrap utilizes. -- Read about what’s included in Bootstrap in our [contents section]([[docsref:/getting-started/contents/]]) and the list of [components that require JavaScript](#js-components) below. +- Read about the list of [components that require JavaScript](#js-components) below. - Need a little more power? Consider building with Bootstrap by [including the source files via package manager]([[docsref:/getting-started/download#package-managers]]). - Looking to use Bootstrap as a module with `