Commit Graph

1123 Commits

Author SHA1 Message Date
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
Daniel Mangum c081dfabd1
Merge pull request #176 from hasheddan/latest-styles
Format CSS styles and fix latest version overlap
2022-10-31 10:33:53 -04:00
hasheddan 3b613b5e51
Fix latest tag overlapping with version
Fixes the latest tag overlapping with the version in the selector.

Signed-off-by: hasheddan <georgedanielmangum@gmail.com>
2022-10-31 10:29:30 -04:00
hasheddan 4abced74c3
Format CSS to be more developer friendly
Uses prettier to format CSS to be more friendly for developers to
interact with.

Signed-off-by: hasheddan <georgedanielmangum@gmail.com>
2022-10-31 10:27:34 -04:00
Pete Lumbis fd52942f91
Merge pull request #175 from upbound/version-alert-fix
Corrects the check to see if this doc is for the latest version.
2022-10-28 14:00:41 -04:00
Daniel Mangum c6e25af575
Merge pull request #174 from hasheddan/1.10-latest
Bump latest release version to v1.10
2022-10-27 13:46:04 -04:00
Pete Lumbis 01034751e5
Corrects the check to see if this doc is for the latest version. Caused by versions param being a string now
Signed-off-by: Pete Lumbis <pete@upbound.io>
2022-10-27 13:22:53 -04:00
hasheddan 5cf5a34bcd
Bump latest release version to v1.10
Updates latest release version to v1.10.

Signed-off-by: hasheddan <georgedanielmangum@gmail.com>
2022-10-26 16:52:25 -04:00
Crossplane e24ea71b78 docs snapshot for crossplane version `master` 2022-10-25 17:57:15 +00:00
Pete Lumbis 2418dbab8e
Merge pull request #171 from upbound/include-error-check
ensure include file exists or error
2022-10-24 16:40:47 -04:00
Daniel Mangum 7a1bb07739
Merge pull request #172 from alezkv/patch-1
Update README.md
2022-10-20 18:05:30 -04:00
Aleksey Zhukov 2c1089c51e
Update README.md
Fix a link. Currently it leads to 404 on `https://github.com/crossplane/crossplane.github.io/blob/master/crossplane.io`

Signed-off-by: Aleksey Zhukov <353748+alezkv@users.noreply.github.com>
2022-10-21 00:01:57 +02:00
Pete Lumbis f86a1b3d82
ensure include file exists or error
Signed-off-by: Pete Lumbis <pete@upbound.io>
2022-10-20 16:27:41 -04: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
Pete Lumbis cab7cad723
Merge pull request #169 from upbound/shortcodes
add placeholder shortcodes
2022-10-18 20:13:08 -04:00
Pete Lumbis a679a8500c
add placeholder shortcodes for upcoming redesign work and new content ported from Upbound docs
Signed-off-by: Pete Lumbis <pete@upbound.io>
2022-10-18 19:56:42 -04: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
Pete Lumbis 3136c89902
Merge pull request #168 from upbound/version-dropdown-v2
Fix version drop down by sorting version strings instead of floats
2022-10-13 22:12:15 -04:00
Pete Lumbis 04abc454f8
Fix version drop down by sorting version strings instead of floats
Signed-off-by: Pete Lumbis <pete@upbound.io>
2022-10-13 22:04:49 -04: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