I was making a fresh clone of this repo when I saw that it was forked
from crossplane.github.io and stated in the README that it was both the
website and docs. This surprised me, since crossplane/docs seemed like a
misleading place to find the website.
I then learned that the website is in fact a separate repo, at
https://github.com/crossplane/website
Signed-off-by: Nic Cope <nicc@rk0n.org>
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.
* Source code is under Apache 2.0 license
* Documentation distributed under CC-BY-4.0
* README clarifies between the two
Signed-off-by: Jared Watts <jbw976@gmail.com>
Jared Watts
Nic Cope
Pete Lumbis
Aleksey Zhukov
Pete Lumbis
Connor Chan
Phil Prasek
hasheddan
Michael Goff