* more contrib info
Signed-off-by: Pete Lumbis <pete@upbound.io>
* expand build and netlify things
Signed-off-by: Pete Lumbis <pete@upbound.io>
* Add lots of comments
Signed-off-by: Pete Lumbis <pete@upbound.io>
* add comments
Signed-off-by: Pete Lumbis <pete@upbound.io>
* +Algolia, DocSearch, NodeJS
Signed-off-by: Pete Lumbis <pete@upbound.io>
---------
Signed-off-by: Pete Lumbis <pete@upbound.io>
* correct set of feature flags for 1.15
Signed-off-by: Pete Lumbis <pete@upbound.io>
* copy master to v1.15
Signed-off-by: Pete Lumbis <pete@upbound.io>
* update version number
Signed-off-by: Pete Lumbis <pete@upbound.io>
* set v1.15 as latest
Signed-off-by: Pete Lumbis <pete@upbound.io>
* update CRD files for v1.15 API docs
Signed-off-by: Pete Lumbis <pete@upbound.io>
* correct version number
Signed-off-by: Pete Lumbis <pete@upbound.io>
* update helm dry run to v1.15
Signed-off-by: Pete Lumbis <pete@upbound.io>
* update helm options for v1.15
Signed-off-by: Pete Lumbis <pete@upbound.io>
* Add registry change notice. Resolves#680
Signed-off-by: Pete Lumbis <pete@upbound.io>
* Add registry change notice. Resolves#680
Signed-off-by: Pete Lumbis <pete@upbound.io>
* add crossplane top and edit crossplane migrate
Signed-off-by: Pete Lumbis <pete@upbound.io>
* remove v1.12 docs
Signed-off-by: Pete Lumbis <pete@upbound.io>
* update trace outputs/options. Resolves#685
Signed-off-by: Pete Lumbis <pete@upbound.io>
* v1.15 release notes
Signed-off-by: Pete Lumbis <pete@upbound.io>
* fix old link to v1.12 docs
Signed-off-by: Pete Lumbis <pete@upbound.io>
* update netlify scripts for v1.15 and add v1.12 redirects
Signed-off-by: Pete Lumbis <pete@upbound.io>
* vale fixes
Signed-off-by: Pete Lumbis <pete@upbound.io>
* + metrics-server
Signed-off-by: Pete Lumbis <pete@upbound.io>
* add link to packages chapter
Signed-off-by: Pete Lumbis <pete@upbound.io>
* update anchor for migrate command
Signed-off-by: Pete Lumbis <pete@upbound.io>
* fold in recent master changes to v1.15 docs
Signed-off-by: Pete Lumbis <pete@upbound.io>
* fold in recent master changes to v1.15 docs
Signed-off-by: Pete Lumbis <pete@upbound.io>
* update v1.15 with fix in #707
Signed-off-by: Pete Lumbis <pete@upbound.io>
* link fixes for htmltest checking
Signed-off-by: Pete Lumbis <pete@upbound.io>
* add in beta validate command
Signed-off-by: Pete Lumbis <pete@upbound.io>
* sync master and v1.15
Signed-off-by: Pete Lumbis <pete@upbound.io>
---------
Signed-off-by: Pete Lumbis <pete@upbound.io>
* Adds sed command to uncomment writeStats
Signed-off-by: Pete Lumbis <pete@upbound.io>
* Enables Hugo writeStats in Netlify environments.
Signed-off-by: Pete Lumbis <pete@upbound.io>
print config file for troubleshooting
Signed-off-by: Pete Lumbis <pete@upbound.io>
add build preview settings
Signed-off-by: Pete Lumbis <pete@upbound.io>
---------
Signed-off-by: Pete Lumbis <pete@upbound.io>
Adds a copy to clipboard button using Clipboard.js
Optional support for defining which lines to copy out of the code box.
Adds styling and anchor links to the line numbers
Adds support to link to line number anchors inside tabs
Removes line numbers from tables (no user impact, changes styling and JS element targeting)
Makes the top NAV not sticky. This is required to make the line number anchors work. Otherwise the line number linked to will go under the navbar and not be in view. Fixing this with a sticky nav is a very large lift (for me). Also note, the side bars are still sticky.
Removes clipboard scsss files. All clipboard related styles are merged into code-theme-base.scss
Also applies Hugo caching fixes that can cause the stylesheet not to load in local dev (discovered in this PR)
* Adds Algolia DocSearch components and manual style overrides
Signed-off-by: Pete Lumbis <pete@upbound.io>
* Auto close menu on mobile when search box is clicked
Signed-off-by: Pete Lumbis <pete@upbound.io>
* Add search hotkey indicators
Signed-off-by: Pete Lumbis <pete@upbound.io>
Signed-off-by: Pete Lumbis <pete@upbound.io>
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.
Jared Watts
Mark Anderson-Trocme
Hasan Turken
Sharp
Pete Lumbis
Pete Lumbis
hasheddan