Commit Graph

14 Commits

Author SHA1 Message Date
Pete Lumbis 2b598cb79f
Remove knowledge base section (#755)
Remove KB and add redirects
2024-04-22 15:44:32 -04:00
Pete Lumbis bd0f99a77f
Add a bunch more contrib info (#758)
* 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>
2024-04-19 10:00:09 -04:00
Pete Lumbis 5256a59ce6
v1.15 Docs (#701)
* 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>
2024-02-15 12:01:21 -05:00
Pete Lumbis 3fb9be9e5e
Remove outdated upgraded guides (#676)
* add redirects for removed KB section

Signed-off-by: Pete Lumbis <pete@upbound.io>

* remove outdated software guides

Signed-off-by: Pete Lumbis <pete@upbound.io>

* fix netlify redirect directive

Signed-off-by: Pete Lumbis <pete@upbound.io>

* remove old link to software pages

Signed-off-by: Pete Lumbis <pete@upbound.io>

---------

Signed-off-by: Pete Lumbis <pete@upbound.io>
2024-01-12 14:26:11 -05:00
Pete Lumbis 5c360ba900
Changes for API support (#642) 2023-12-01 15:11:06 -05:00
Pete Lumbis 5dcc5b814a
V1.14 release (#596)
Co-authored-by: Philippe Scorsolini <p.scorsolini@gmail.com>
Co-authored-by: Nic Cope <nicc@rk0n.org>
Co-authored-by: Hasan Turken <turkenh@gmail.com>
2023-11-01 10:47:28 -04:00
Jean du Plessis 4b64498e7d Switch to using the latest version of hugo
Signed-off-by: Jean du Plessis <jean@upbound.io>
2023-06-20 06:29:04 +02:00
Pete Lumbis 8b7ba241eb
Add redirects for top 404 pages
Signed-off-by: Pete Lumbis <pete@upbound.io>
2023-06-01 20:01:01 -04:00
Pete Lumbis bff3de632c
Search index only for /latest (#423) 2023-05-01 10:12:39 -04:00
Pete Lumbis 7864da34b7
v1.12 Docs Release (#414) 2023-04-25 13:33:38 -04:00
Pete Lumbis 85407e88c6
Docs Reorg for v1.11 (#271)
Reorg and new home page for docs.
2023-01-31 18:59:52 -05:00
Pete Lumbis f41844b589
Remove extra && (#303)
Signed-off-by: Pete Lumbis <pete@upbound.io>
2023-01-30 11:55:59 -05:00
Pete Lumbis 4b886caef9
Improve Build Speed (#300)
* 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>
2023-01-30 11:48:49 -05: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