* update macro to lookup point releases for artifacts
* remove trailing whitespace
* use vargs to be explicit
* name the github client more explicitly
* drop pre-v1 support
* better naming for GithubRleases
* remove the full knative-prefix
* allow the macro helper to accept knative-v1.3.0 and v1.30.0
* handle the repos with bad tags
* better log message
* support go tag format as a fallback
* refactor so we use the GitHub release tag
Some repos we link to don't have the knative- prefix in their release tag
* add v0.25 mkdocs, remove v0.21 hugo
Signed-off-by: Carlos Santana <csantana23@gmail.com>
* remove v0.21 hugo archived
Signed-off-by: Carlos Santana <csantana23@gmail.com>
* add -L for curl to catch errors when missing variabled in url path
Signed-off-by: Carlos Santana <csantana23@gmail.com>
* fix release branch for old mkdocs version 0.24
Signed-off-by: Carlos Santana <csantana23@gmail.com>
* fix message for serve
Signed-off-by: Carlos Santana <csantana23@gmail.com>
* adding back archive v0.21 to make PR clear
Signed-off-by: Carlos Santana <csantana23@gmail.com>
* Incorporate static version of old docs in to site
Built via manual ./scripts/build.sh of website and then copied over.
Each release we get to delete one of these docs directories (and the
corresponding copy in build.sh) until they all disappear.
* Clean up built owners files
* Mv old-docs archived
* Mark archived/ dir as generated
* Add cookie warning to site
Imports the cookie warning from the old site. For simplicity,
this uses the same script from the old site in both places, so we
have to import jquery.
Note: this doesn't actually turn analytics on, but we now could do so.
* Tweak margins
* Add non-EU version
* handle old versions with redirects
Signed-off-by: Carlos Santana <csantana23@gmail.com>
* skip building the files for redirect take effect
Signed-off-by: Carlos Santana <csantana23@gmail.com>
* trailing whitespace
Signed-off-by: Carlos Santana <csantana23@gmail.com>
* Branch-based versioning
* Tidy, add version warning
* Use shallow clones
* use npx
* Tidy, optimise
* update branches
* Looks like we need this bit of processresourcefiles.sh
* Use array instead of function
* Allow specifying community repo commit/branch
* Allow overriding repos
* Document prereqs
* Add explicit path for hugo build
* Relative latest version url
* deploy to gh-pages with blog
Signed-off-by: Carlos Santana <csantana23@gmail.com>
* add hugo
Signed-off-by: Carlos Santana <csantana23@gmail.com>
* extended true
Signed-off-by: Carlos Santana <csantana23@gmail.com>
* add postcss to PATH
Signed-off-by: Carlos Santana <csantana23@gmail.com>
* make it compatible with other forks not name docs
Signed-off-by: Carlos Santana <csantana23@gmail.com>
* mkade blog and community relatove
Signed-off-by: Carlos Santana <csantana23@gmail.com>
* restore github action to mkdocs
Signed-off-by: Carlos Santana <csantana23@gmail.com>
* add gh-action to deploy mkdocs to gh-pages
* update commit user for gh-pages
Signed-off-by: Carlos Santana <csantana23@gmail.com>
* switch to fast livereload
Signed-off-by: Carlos Santana <csantana23@gmail.com>
* initial move over
* Fix up index page names
* Add version variables
* Escape macro syntax
* Automatic fixups with mkhugo
* Drop no-longer-needed excludes
* Rename more _index files
* Move broker-configmaps.md a README.md
avoids a directory with no index/readme
* Autogenerate Eventing nav
* Fix markdown
* Update Serving nav
* Add h1 headers
Makes things look nicer in github, and makes search work more accurately
in mkdocs
* Unexclude all samples
* Correct client link
* Fix gitignore, skip hugo tests
* Update api doc config
Duck no longer lives in github.com/knative, and networking package has
been introduced. Also fill in a couple other packages to remove warnings
when run
* Regenerate api references
* update gen-api-reference-docs script
Updating the tool version to v0.3.0 tag.
Ran locally against v0.20.0 tag for serving/eventing repos, seems to be
working fine.
Signed-off-by: Ahmet Alp Balkan <ahmetb@google.com>
* re-run api reference docs generation
Signed-off-by: Ahmet Alp Balkan <ahmetb@google.com>
* remove eventing-contrib
* update gen-crd-api-reference-docs version to fix API build errors
* API docs build for 0.19
* revert API version and add troubleshooting docs
* revert file
* remove whitespace
* Update docs/reference/api/README.md
Co-authored-by: Mike Petersen <mike.petersen@ibm.com>
* add more detail
* and now fix my typo
Co-authored-by: Mike Petersen <mike.petersen@ibm.com>
* Adjust API reference docs scripts for knative.dev
The API reference docs were failing to generate because they didn't
account for the change from github.com/knative/serving to
knative.dev/serving and similar for the eventing and eventing-contrib
repos.
* change to _IMPORT_PATH
This bumps the `gen-crd-api-reference-docs` to v0.1.5 which has two notable
fixes impacting Knative:
1. Prevent types in same apiGroup but different apiVersion (e.g v1beta1 vs
v1alpha1) from grouped together.
2. De-duplicate the apiGroups list when types belonging to that api group come
from different Go packages.
Fixes#1559.
Signed-off-by: Ahmet Alp Balkan <ahmetb@google.com>
This updates to a recent version of gen-crd-api-reference-docs and allows
customizing the -api-dir option so that the docs for theeventing-contrib repo
can be generated.
Signed-off-by: Ahmet Alp Balkan <ahmetb@google.com>