Skip to content

GA: Publish v1 docs for GitRepository, Receiver & Kustomization#1427

Merged
stefanprodan merged 4 commits intomainfrom
rcv-v1
Apr 6, 2023
Merged

GA: Publish v1 docs for GitRepository, Receiver & Kustomization#1427
stefanprodan merged 4 commits intomainfrom
rcv-v1

Conversation

@makkes
Copy link
Copy Markdown
Member

@makkes makkes commented Mar 23, 2023

Changes:

  • adapt docs script to...
    • take into account the v1 split
    • consume weight comments for proper ordering of pages
  • add both v1 and v1beta2 generated docs under "References" section
  • update references to old API versions on all pages

Comment thread hack/import-flux2-assets.sh
@makkes makkes force-pushed the rcv-v1 branch 5 times, most recently from 818be4e to d068deb Compare March 23, 2023 16:04
@makkes makkes marked this pull request as ready for review March 23, 2023 16:35
@makkes makkes requested a review from a team March 23, 2023 16:35
@stefanprodan stefanprodan added the hold Issues and pull requests put on hold label Mar 23, 2023
@stefanprodan
Copy link
Copy Markdown
Member

It looks great! Thanks @makkes

I've put this on hold until we release NC, then you can switch back to semver in the script.

@stefanprodan stefanprodan changed the title GA: adapt to n-c Receiver API graduating to v1 GA: Publish v1 docs for GitRepository & Receiver Mar 28, 2023
@makkes makkes changed the title GA: Publish v1 docs for GitRepository & Receiver GA: Publish v1 docs for GitRepository, Receiver & Kustomization Mar 30, 2023
makkes pushed a commit to fluxcd/notification-controller that referenced this pull request Mar 30, 2023
This commit bumps the Receiver API version to v1 in preparation of
the Flux GitOps GA milestone
(https://fluxcd.io/roadmap/#flux-gitops-ga-q1-2023).

We are now actively maintaining two versions of the notification API
group in parallel: v1 which currently only holds the Receiver kind and
v1beta2 for all other kinds.

Since we haven't run into this situation before, I had to change the
way we expose the API docs in ./docs/api: The directory now has
sub-directories for each active API version. Therefore we need to
change our scripts in the website repository to take this change into
account so that we expose both API group version at
https://fluxcd.io/flux/components/notification/api/. This change is
implemented in fluxcd/website#1427.

refs #436

Signed-off-by: Max Jonas Werner <mail@makk.es>
alekspog pushed a commit to alekspog/notification-controller that referenced this pull request Mar 30, 2023
This commit bumps the Receiver API version to v1 in preparation of
the Flux GitOps GA milestone
(https://fluxcd.io/roadmap/#flux-gitops-ga-q1-2023).

We are now actively maintaining two versions of the notification API
group in parallel: v1 which currently only holds the Receiver kind and
v1beta2 for all other kinds.

Since we haven't run into this situation before, I had to change the
way we expose the API docs in ./docs/api: The directory now has
sub-directories for each active API version. Therefore we need to
change our scripts in the website repository to take this change into
account so that we expose both API group version at
https://fluxcd.io/flux/components/notification/api/. This change is
implemented in fluxcd/website#1427.

refs fluxcd#436

Signed-off-by: Max Jonas Werner <mail@makk.es>
makkes pushed a commit that referenced this pull request Apr 3, 2023
We changed the directory structure of the specs in the respective
controllers' v1 versions. Until a full Flux release has been cut we
need to exclude all v1 versions from being imported until #1427 has
landed.

Signed-off-by: Max Jonas Werner <mail@makk.es>
@makkes makkes force-pushed the rcv-v1 branch 3 times, most recently from c0db154 to 819539d Compare April 5, 2023 12:07
Max Jonas Werner added 4 commits April 5, 2023 14:12
The following API types have been graduated to v1:

- NC Receiver
- KC Kustomization
- SC GitRepository

In addition to that we want the API navigation entries to appear at
the bottom of the tree. To accomplish that the import script is now
able to parse a weight parameter from imported markdown specs and put
it into the front matter of the resulting file.

refs fluxcd/notification-controller#436

Signed-off-by: Max Jonas Werner <mail@makk.es>
- GitRepository v1
- Kustomization v1
- Receiver v1
- CronJob v1

Signed-off-by: Max Jonas Werner <mail@makk.es>
Signed-off-by: Max Jonas Werner <mail@makk.es>
refs fluxcd/flux2#3731

Signed-off-by: Max Jonas Werner <mail@makk.es>
Copy link
Copy Markdown
Member

@stefanprodan stefanprodan left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Thanks @makkes 🥇

@stefanprodan stefanprodan merged commit 62954c9 into main Apr 6, 2023
@stefanprodan stefanprodan deleted the rcv-v1 branch April 6, 2023 12:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

hold Issues and pull requests put on hold

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants