Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Reword the changelog fragments to better generate the CHANGELOG.md when we release 1.0. #3544

Closed
wants to merge 28 commits into from

Conversation

jmrodri
Copy link
Member

@jmrodri jmrodri commented Jul 25, 2020

Description of the change:
Reword the changelog fragments to better generate the CHANGELOG.md when we release 1.0.

Motivation for the change:
Preparing for a 1.0 CHANGELOG.

Checklist

If the pull request includes user-facing changes, extra documentation is required:

@jmrodri jmrodri changed the title Changelog wordsmith Reword the changelog fragments to better generate the CHANGELOG.md when we release 1.0. Jul 25, 2020
@joelanford joelanford mentioned this pull request Jul 25, 2020
92 tasks
Copy link
Contributor

@camilamacedo86 camilamacedo86 left a comment

Choose a reason for hiding this comment

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

I am ok with the fixes in the changelog. 👍
/lgtm

However, as we spoke I think we can simplify by combining some changes. Add here my suggestions as well.

@openshift-ci-robot openshift-ci-robot added the lgtm Indicates that a PR is ready to be merged. label Jul 27, 2020
changelog/fragments/mv-EnqueueRequestForAnnotation.yaml Outdated Show resolved Hide resolved
changelog/fragments/remove-pkg-predicate.yaml Show resolved Hide resolved
changelog/fragments/rename-max-workers.yaml Outdated Show resolved Hide resolved
changelog/fragments/rm-legacy-gen-bundle.yaml Outdated Show resolved Hide resolved
changelog/fragments/rm-legacy-bundle-cmds.yaml Outdated Show resolved Hide resolved
changelog/fragments/rm-legacy-go.yaml Outdated Show resolved Hide resolved
changelog/fragments/rm-legacy-run.yaml Outdated Show resolved Hide resolved
changelog/fragments/scorecard-move-alpha.yaml Outdated Show resolved Hide resolved
changelog/fragments/scorecard-parallel.yaml Show resolved Hide resolved
Comment on lines +5 to +7
Ansible & Helm-based Operators switched to using the `InstrumentedEnqueueRequestForObject` from
[operator-lib](https://github.com/operator-framework/operator-lib/blob/main/handler/instrumented_enqueue_object.go)
instead of controller-runtime's `EnqueueRequestForObject`.
Copy link
Member

Choose a reason for hiding this comment

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

This should be consolidated with the removal of legacy metrics generation in Helm and Ansible operators fragments (again, in the release prep PR)

@@ -2,7 +2,7 @@
# release notes and/or the migration guide
entries:
- description: >
The commands `operator-sdk new --type=ansible` and `operator-sdk add api` are no longer supported for Ansible-based Operators.
Removed legacy `new` and `add api` commands from Ansible-based Operators.
Copy link
Contributor

@camilamacedo86 camilamacedo86 Jul 27, 2020

Choose a reason for hiding this comment

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

All legacy removals IMO could be replaced for one fragment:

# entries is a list of entries to include in
# release notes and/or the migration guide
entries:
  - description: >
      Remove support for the legacy layout. Operator SDK has a new CLI and project layout that is aligned with Kubebuilder. (//todo: add all pr's numbers)
      
    kind: "removal"
    # Is this a breaking change?
    breaking: yes
    # Migration can be defined to automatically add a section to
    # the migration guide. This is required for breaking changes.
    migration:
      header: Migrate your projects for the new layout
      body: >
        Operator SDK has a new CLI and project layout that is aligned with Kubebuilder.
        See `operator-sdk init -h` and the following doc on how to scaffold a new project:
        To migrate existing projects to the new layout see the migrations guides in
        https://sdk.operatorframework.io.
        - For Go-based Operators: https://master.sdk.operatorframework.io/docs/building-operators/golang/project_migration_guide/
        - For Helm-based Operators: https://master.sdk.operatorframework.io/docs/building-operators/helm/migration/
        - For Ansible-based Operators: TBD

Wdyt @joelanford

Added `--metrics-addr` flag to helm operator to make it configurable, and
changed the default from `:8383` to `:8080`
Added `--metrics-addr` flag to the Helm operator to make it configurable, and
changed the default port from `:8383` to `:8080`
Copy link
Contributor

@camilamacedo86 camilamacedo86 Jul 27, 2020

Choose a reason for hiding this comment

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

IMO we can combine the metrics change for Ansible and Helm:

Breaking change: (Valid only for Ansible/Helm-based Operators). Added --metrics-addr flag to make it configurable, and changed the default port used by the metric endpoint binds to from :8383 to :8080. (#3489, #3440)

@jmrodri jmrodri force-pushed the changelog-wordsmith branch from 61adfa1 to ef724c0 Compare July 27, 2020 16:17
@openshift-ci-robot
Copy link

New changes are detected. LGTM label has been removed.

@openshift-ci-robot openshift-ci-robot removed the lgtm Indicates that a PR is ready to be merged. label Jul 27, 2020
@jmrodri jmrodri force-pushed the changelog-wordsmith branch from ef724c0 to 70d30a4 Compare July 27, 2020 19:03
@jmrodri jmrodri force-pushed the changelog-wordsmith branch from 3dd4888 to 263e232 Compare July 27, 2020 19:34
@jmrodri
Copy link
Member Author

jmrodri commented Jul 27, 2020

Closing this pull request in favor of the upcoming release PR.

@jmrodri jmrodri closed this Jul 27, 2020
@jmrodri jmrodri deleted the changelog-wordsmith branch August 17, 2020 15:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants