Commit Graph

609 Commits

Author SHA1 Message Date
Crossplane b5ae460f09 docs snapshot for crossplane version `v1.9` 2022-12-01 21:48:38 +00:00
Crossplane ec79756e2b docs snapshot for crossplane version `v1.10` 2022-12-01 21:47:53 +00:00
Crossplane 537b881736 docs snapshot for crossplane version `v1.8` 2022-12-01 21:47:31 +00:00
Crossplane dd68f7e9dc docs snapshot for crossplane version `master` 2022-12-01 17:18:34 +00:00
Crossplane 6d1813ebb7 docs snapshot for crossplane version `v1.9` 2022-12-01 17:04:14 +00:00
Crossplane 64e9a1b77f docs snapshot for crossplane version `v1.10` 2022-12-01 16:51:55 +00:00
Crossplane 2cf952e84a docs snapshot for crossplane version `v1.8` 2022-12-01 16:35:34 +00:00
Pete Lumbis f1e0f4d865
Docs redesign (#210)
This completely redesigns the docs and moves them to a new domain docs.crossplane.io and hosting on Netlify. 

This creates a custom Hugo theme affectionally called `Geekboot` based the work of both [Geekdoc](https://geekdocs.de/) and [Bootstrap](https://github.com/twbs/bootstrap/tree/main/site).

[Lighthouse testing on desktop](https://pagespeed.web.dev/report?url=https%3A%2F%2Fdocs.crossplane.io%2Fv1.10%2F&form_factor=desktop) gives the site a 100/100 in performance and best practices, 90/100 in accessibility and 92/100 in SEO.

Besides new layout and colors other new user-facing features include:
* Dark mode
* Fully responsive design and mobile ready
* Automated webp image conversion and optimization as well as lazy loading
* Tabs 
* Alerts and hint boxes
* Foldable/hide long outputs
* Linkable anchors inside tabs
* Improved code boxes with line numbers 
* Adds support for docs.crossplane.io/latest
* Right hand page table of contents 
* Improved text readability 

Infrastructure improves:
* Uses [Bootstrap](https://getbootstrap.com/) to dramatically simplify styling and site development 
* Prefetch links on hover using [instant.page](https://instant.page/)
* Highly optimized CSS using PostCSS and [PurgeCSS ](https://purgecss.com/) without requiring users to install additional tools
* Minimizes the use of JavaScript and bundles scripts with [Webpack](https://webpack.js.org/) to optimize load times
* Massive improvement of SCSS/CSS organization and overrides improving the development process for stylesheet changes
* Optimizes existing SVGs and converts all other template images to webp
* Minification on production builds to further reduce page sizes

This also bumps the `Makefile` Hugo version to [0.107.0](https://github.com/gohugoio/hugo/releases/tag/v0.107.0) to pick up build improvements related to code syntax highlighting, improving builds about about 20-30% in unscientific testing.
2022-12-01 11:11:29 -05:00
Crossplane 6c606dcbef docs snapshot for crossplane version `master` 2022-12-01 14:19:51 +00:00
Crossplane df2ab44041 docs snapshot for crossplane version `master` 2022-11-30 01:56:07 +00:00
Crossplane b41b8c6d48 docs snapshot for crossplane version `v1.10` 2022-11-30 01:38:31 +00:00
Crossplane cee2291c5b docs snapshot for crossplane version `master` 2022-11-28 22:33:05 +00:00
Crossplane a480f43bfd docs snapshot for crossplane version `master` 2022-11-28 17:22:15 +00:00
Crossplane 1620c20c06 docs snapshot for crossplane version `v1.10` 2022-11-28 17:13:00 +00:00
Crossplane 6cef36f23f docs snapshot for crossplane version `master` 2022-11-23 09:34:42 +00:00
Crossplane f4c5f5d858 docs snapshot for crossplane version `master` 2022-11-18 23:43:42 +00:00
Crossplane d8b0918321 docs snapshot for crossplane version `master` 2022-11-18 00:25:50 +00:00
Crossplane 874f21a0e4 docs snapshot for crossplane version `v1.9` 2022-11-10 12:37:17 +00:00
Crossplane dbe3dde913 docs snapshot for crossplane version `v1.8` 2022-11-10 12:31:56 +00:00
Crossplane 10ec29e0e6 docs snapshot for crossplane version `v1.10` 2022-11-10 12:31:33 +00:00
Crossplane e10418da19 docs snapshot for crossplane version `master` 2022-11-10 11:36:00 +00:00
Crossplane 631802512c docs snapshot for crossplane version `master` 2022-11-07 08:52:07 +00:00
Crossplane b721885a5c docs snapshot for crossplane version `master` 2022-11-02 11:24:12 +00:00
Crossplane 5a3ed2d74b docs snapshot for crossplane version `v1.7` 2022-11-01 14:24:50 +00:00
Crossplane c3e30568d0 docs snapshot for crossplane version `v1.10` 2022-10-31 22:10:16 +00:00
Crossplane e24ea71b78 docs snapshot for crossplane version `master` 2022-10-25 17:57:15 +00:00
Crossplane aaeaa47af5 docs snapshot for crossplane version `v1.10` 2022-10-20 13:52:38 +00:00
Crossplane 18a2423725 docs snapshot for crossplane version `master` 2022-10-20 13:12:56 +00:00
Crossplane 96847cef62 docs snapshot for crossplane version `v1.10` 2022-10-18 09:45:50 +00:00
Crossplane 9e04b5c80d docs snapshot for crossplane version `v1.10` 2022-10-18 08:28:21 +00:00
Crossplane ae0c6218e3 docs snapshot for crossplane version `v1.9` 2022-10-17 13:45:16 +00:00
Crossplane 0926954a00 docs snapshot for crossplane version `v1.9` 2022-10-17 10:38:07 +00:00
Crossplane 4da9ac7a11 docs snapshot for crossplane version `v1.9` 2022-10-14 01:35:26 +00:00
Crossplane cc1c4b5587 docs snapshot for crossplane version `v1.8` 2022-10-14 01:35:11 +00:00
Crossplane 782785518f docs snapshot for crossplane version `v1.7` 2022-10-14 01:34:55 +00:00
Crossplane 7decd43ebd docs snapshot for crossplane version `v1.10` 2022-10-14 01:34:10 +00:00
Crossplane d6bb4fe88e docs snapshot for crossplane version `v1.10` 2022-10-14 00:11:16 +00:00
Crossplane 690de145d3 docs snapshot for crossplane version `master` 2022-10-13 22:11:30 +00:00
Crossplane b74c98006d docs snapshot for crossplane version `master` 2022-10-13 00:30:19 +00:00
Crossplane 1a34c00b2a docs snapshot for crossplane version `master` 2022-10-12 21:46:44 +00:00
Crossplane ae5e53ba0e docs snapshot for crossplane version `v1.10` 2022-10-12 16:11:48 +00:00
Crossplane 6a2bf1aa86 docs snapshot for crossplane version `v1.10` 2022-10-12 13:23:55 +00:00
Crossplane f4f0f12932 docs snapshot for crossplane version `v1.8` 2022-10-11 14:32:36 +00:00
Crossplane 80a19ecdcf docs snapshot for crossplane version `v1.9` 2022-10-11 14:30:09 +00:00
Crossplane dca9f57b72 docs snapshot for crossplane version `v1.7` 2022-10-11 14:27:51 +00:00
Crossplane 86391397c0 docs snapshot for crossplane version `master` 2022-10-11 11:29:57 +00:00
Crossplane e5b950162d docs snapshot for crossplane version `master` 2022-10-10 21:42:39 +00:00
Pete Lumbis 21c5470488
update links to reflect new URL schemes
Signed-off-by: Pete Lumbis <pete@upbound.io>
2022-10-10 09:38:14 -04:00
Pete Lumbis 0a00dc4bb1
Updates the /docs redirect to always go to what is globally defined as the latest version
Signed-off-by: Pete Lumbis <pete@upbound.io>
2022-10-07 18:08:22 -04:00
Pete Lumbis b49ad85c67
update link to docs root
Signed-off-by: Pete Lumbis <plumbis@users.noreply.github.com>
2022-10-07 17:50:35 -04:00
Pete Lumbis f81ae95e57
move docs content to /docs. Update left nav menu and dropdown menu for new layout
Signed-off-by: Pete Lumbis <plumbis@users.noreply.github.com>
2022-10-07 17:43:56 -04:00
Pete Lumbis fdf7203acb
Merge github.com:crossplane/crossplane.github.io
Signed-off-by: Pete Lumbis <pete@upbound.io>
2022-10-05 11:57:09 -04:00
Pete Lumbis b4d2128d45
fix merge conflict
Signed-off-by: Pete Lumbis <pete@upbound.io>
2022-10-05 11:10:08 -04:00
Pete Lumbis 02bb32c0d7
add alias for /docs
Signed-off-by: Pete Lumbis <pete@upbound.io>
2022-10-05 11:10:07 -04:00
Pete Lumbis c01409f9f0
add instructions to contribute to crossplane.io
Signed-off-by: Pete Lumbis <pete@upbound.io>
2022-10-05 11:10:07 -04:00
Pete Lumbis 4f460fb2de
update to sync with upstream docs snapshots
Signed-off-by: Pete Lumbis <pete@upbound.io>
2022-10-05 11:10:07 -04:00
Pete Lumbis ad554546c2
404 page type to generate 404.html for webhosting service
Signed-off-by: Pete Lumbis <pete@upbound.io>
2022-10-05 11:10:06 -04:00
Pete Lumbis ab8bf8b119
move community page into hugo content directory
Signed-off-by: Pete Lumbis <pete@upbound.io>
2022-10-05 11:10:03 -04:00
Pete Lumbis f4a8981b63
move docs to content directory for hugo
Signed-off-by: Pete Lumbis <pete@upbound.io>
2022-10-05 11:10:02 -04:00