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

Remove Optimize C7 content #4785

Merged
merged 24 commits into from
Jan 15, 2025
Merged

Remove Optimize C7 content #4785

merged 24 commits into from
Jan 15, 2025

Conversation

akeller
Copy link
Member

@akeller akeller commented Dec 17, 2024

Description

First pass at removing C7 content from /next/.

Note - some files from the non-/next/ version were touched due to link issues (mainly the links were pointing to a version outside of their version... which is not ideal for reasons like this). There are a LOT of changes, but let's start with reviewing this set and then backport the changes in separate PRs. To get the build working, some links were replaced with #.

Related to https://github.com/camunda/product-hub/issues/1247.

When should this change go live?

  • This is a bug fix, security concern, or something that needs urgent release support.
  • This is already available but undocumented and should be released within a week.
  • This on a specific schedule and the assignee will coordinate a release with the DevEx team. (apply hold label or convert to draft PR)
  • This is part of a scheduled alpha or minor. (apply alpha or minor label)
  • There is no urgency with this change and can be released at any time.

PR Checklist

  • My changes are for an already released minor and are in /versioned_docs directory.
  • My changes are for the next minor and are in /docs directory (aka /next/).

@akeller akeller added component:optimize Issues related with Optimize project deploy Stand up a temporary docs site with this PR labels Dec 17, 2024
@akeller akeller self-assigned this Dec 17, 2024
Copy link
Contributor

github-actions bot commented Dec 17, 2024

👋 🤖 🤔 Hello, @akeller! Did you make your changes in all the right places?

These files were changed only in docs/. You might want to duplicate these changes in versioned_docs/version-8.6/.

  • docs/components/concepts/data-retention.md
These files were changed only in optimize/. You might want to duplicate these changes in optimize_versioned_docs/version-3.14.0/.
  • optimize/components/userguide/additional-features/footer.md
  • optimize/components/userguide/combined-process-reports.md
  • optimize/components/userguide/decision-analysis/decision-analysis-overview.md
  • optimize/components/userguide/decision-analysis/decision-filter.md
  • optimize/components/userguide/decision-analysis/decision-report.md
  • optimize/components/userguide/decision-analysis/img/dmn_date_chart.png
  • optimize/components/userguide/decision-analysis/img/dmn_decision_table.png
  • optimize/components/userguide/decision-analysis/img/dmn_pie_chart.png
  • optimize/components/userguide/decision-analysis/img/dmn_progress_bar.png
  • optimize/components/userguide/decision-analysis/img/dmn_raw_data_report.png
  • optimize/components/userguide/decision-analysis/img/dmn_report_create.png
  • optimize/components/userguide/decision-analysis/img/report-with-filterlist-open.png
  • optimize/components/userguide/decision-analysis/img/zoom-in.png
  • optimize/self-managed/optimize-deployment/advanced-features/engine-data-deletion.md
  • optimize/self-managed/optimize-deployment/advanced-features/img/Import-Service-Polling.png
  • optimize/self-managed/optimize-deployment/advanced-features/img/Import-performance-diagramms-logistic_large.png
  • optimize/self-managed/optimize-deployment/advanced-features/img/Import-performance-diagramms-logistic_medium.png
  • optimize/self-managed/optimize-deployment/advanced-features/img/Import-performance-diagramms-sales.png
  • optimize/self-managed/optimize-deployment/advanced-features/img/Optimize-Import-Process.png
  • optimize/self-managed/optimize-deployment/advanced-features/img/Optimize-Structure.png
  • optimize/self-managed/optimize-deployment/advanced-features/import-guide.md
  • optimize/self-managed/optimize-deployment/configuration/getting-started.md
  • optimize/self-managed/optimize-deployment/configuration/license.md
  • optimize/self-managed/optimize-deployment/configuration/multi-tenancy.md
  • optimize/self-managed/optimize-deployment/configuration/object-variables.md
  • optimize/self-managed/optimize-deployment/configuration/system-configuration-platform-7.md
  • optimize/self-managed/optimize-deployment/configuration/webhooks.md
  • optimize/self-managed/optimize-deployment/migration-update/camunda-7/2.1-to-2.2.md
  • optimize/self-managed/optimize-deployment/migration-update/camunda-7/2.2-to-2.3.md
  • optimize/self-managed/optimize-deployment/migration-update/camunda-7/2.3-to-2.4.md
  • optimize/self-managed/optimize-deployment/migration-update/camunda-7/2.4-to-2.5.md
  • optimize/self-managed/optimize-deployment/migration-update/camunda-7/2.5-to-2.6.md
  • optimize/self-managed/optimize-deployment/migration-update/camunda-7/2.6-to-2.7.md
  • optimize/self-managed/optimize-deployment/migration-update/camunda-7/3.0-to-3.1.md
  • optimize/self-managed/optimize-deployment/migration-update/camunda-7/3.1-to-3.2.md
  • optimize/self-managed/optimize-deployment/migration-update/camunda-7/3.11-to-3.12.md
  • optimize/self-managed/optimize-deployment/migration-update/camunda-7/3.12-to-3.13.md
  • optimize/self-managed/optimize-deployment/migration-update/camunda-7/3.13-to-3.14.md
  • optimize/self-managed/optimize-deployment/migration-update/camunda-7/3.2-to-3.3.md
  • optimize/self-managed/optimize-deployment/migration-update/camunda-7/3.3-to-3.4.md
  • optimize/self-managed/optimize-deployment/migration-update/camunda-7/3.4-to-3.5.md
  • optimize/self-managed/optimize-deployment/migration-update/camunda-7/3.5-to-3.6.md
  • optimize/self-managed/optimize-deployment/migration-update/camunda-7/3.6-to-3.7.md
  • optimize/self-managed/optimize-deployment/migration-update/camunda-7/3.7-to-3.8.md
  • optimize/self-managed/optimize-deployment/migration-update/camunda-7/3.8-to-3.9-preview.md
  • optimize/self-managed/optimize-deployment/migration-update/camunda-7/3.9-preview-to-3.9.md
  • optimize/self-managed/optimize-deployment/migration-update/camunda-7/img/private_report_access_1_create_collection.png
  • optimize/self-managed/optimize-deployment/migration-update/camunda-7/img/private_report_access_2_create_view_permission_mary.png
  • optimize/self-managed/optimize-deployment/migration-update/camunda-7/img/private_report_access_3_1_copy_report.png
  • optimize/self-managed/optimize-deployment/migration-update/camunda-7/img/private_report_access_3_2_copy_report.png
  • optimize/self-managed/optimize-deployment/migration-update/camunda-7/img/private_report_access_4_mary_sees_collection.png
  • optimize/self-managed/optimize-deployment/migration-update/camunda-7/instructions.md
  • optimize/self-managed/optimize-deployment/plugins/businesskey-import-plugin.md
  • optimize/self-managed/optimize-deployment/plugins/decision-import-plugin.md
  • optimize/self-managed/optimize-deployment/plugins/elasticsearch-header.md
  • optimize/self-managed/optimize-deployment/plugins/engine-rest-filter-plugin.md
  • optimize/self-managed/optimize-deployment/plugins/plugin-system.md
  • optimize/self-managed/optimize-deployment/plugins/single-sign-on.md
  • optimize/self-managed/optimize-deployment/plugins/variable-import-plugin.md
  • optimize/self-managed/optimize-deployment/reimport.md
  • optimize/self-managed/optimize-deployment/version-policy.md

You may have done this intentionally, but we wanted to point it out in case you didn't. You can read more about the versioning within our docs in our documentation guidelines.

@akeller
Copy link
Member Author

akeller commented Dec 17, 2024

@toco-cam @RomanJRW, I've done a very quick draft PR to remove Optimize C7 content from /next/ docs. One way you can help my team is verifying that this is indeed the correct content we should remove. In some cases it's full pages, sections, or parts of a page.

Can you remind me how far you want to backport this? We'll also do our best to support redirects to docs.camunda.org, but redirects to a different domain might have unintended SEO consequences or issues.

Copy link
Contributor

@RomanJRW RomanJRW left a comment

Choose a reason for hiding this comment

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

Some initial comments. Can I get a preview env? Would also be able to provide further feedback if I can

Comment on lines -170 to -173
- `SPRING_SECURITY_OAUTH2_RESOURCESERVER_JWT_JWK_SET_URI` Complete URI to get public keys for JWT validation, e.g. `https://weblogin.cloud.company.com/.well-known/jwks.json`. For more details see [public API authentication](../../apis-tools/optimize-api/optimize-api-authentication.md).
- `OPTIMIZE_API_ACCESS_TOKEN` secret static shared token to be provided to the secured REST API on access in the authorization header. Will
be ignored if `SPRING_SECURITY_OAUTH2_RESOURCESERVER_JWT_JWK_SET_URI` is also set. For more details see [public API
authentication](../../apis-tools/optimize-api/optimize-api-authentication.md).
Copy link
Contributor

Choose a reason for hiding this comment

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

I think this is C8-related, but might be going away anyway with the Identity changes. @matthewBearCamunda - will this still be relevant going forward?

Copy link
Member Author

Choose a reason for hiding this comment

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

It was in a C7 labeled section, but please double check.

Copy link
Member Author

Choose a reason for hiding this comment

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

@matthewBearCamunda, can you take a look at this?

Copy link
Contributor

Choose a reason for hiding this comment

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

@akeller - I'll figure this out, I'm unsure if this will be going away or not

Copy link
Member Author

Choose a reason for hiding this comment

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

All good, to keep the momentum with this PR, I'll leave it for now and can follow up if the rest of the PR looks good to merge. If that happens, I'll turn this into a separate issue and assign it to you @matthewBearCamunda. Thanks!

Copy link
Member Author

Choose a reason for hiding this comment

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

@matthewBearCamunda assigned this issue to you, but please feel free to edit the issue so it makes sense to you.

@akeller
Copy link
Member Author

akeller commented Dec 17, 2024

@RomanJRW you are too quick! I am working on getting the deploy running. I'll try to add in your feedback, but this is already a great start!

@akeller akeller added deploy Stand up a temporary docs site with this PR and removed deploy Stand up a temporary docs site with this PR labels Dec 17, 2024
@akeller akeller added the hold This issue is parked, do not merge. label Dec 17, 2024
@akeller akeller requested a review from RomanJRW December 17, 2024 23:31
@github-actions github-actions bot temporarily deployed to camunda-docs December 17, 2024 23:34 Destroyed
| webhookAlerting.webhooks.$\{webhookName}.proxy.host | | The proxy host to use, must be set if webhookAlerting.webhooks.$\{webhookName}.proxy.enabled = true. |
| webhookAlerting.webhooks.$\{webhookName}.proxy.port | | The proxy port to use, must be set if webhookAlerting.webhooks.$\{webhookName}.proxy.enabled = true. |
| webhookAlerting.webhooks.$\{webhookName}.proxy.sslEnabled | | Whether this proxy is using a secured connection (HTTPS). Must be set if webhookAlerting.webhooks.$\{webhookName}.proxy.enabled = true. |

### History cleanup settings

Settings for automatic cleanup of historic process/decision instances based on their end time.
Copy link
Contributor

Choose a reason for hiding this comment

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

Also on this page, we can delete the following lines:

  • plugin.directory
  • plugin.variableImport.basePackages
  • plugin.authenticationExtractor.basePackages
  • plugin.engineRestFilter.basePackages
  • plugin.decisionInputImport.basePackages
  • plugin.decisionOutputImport.basePackages
  • plugin.elasticsearchCustomHeader.basePackages
  • serialization.engineDateFormat
  • historyCleanup.ingestedEventCleanup.enabled
  • historyCleanup.decisionDataCleanup .perDecisionDefinitionConfig.${key}.ttl
  • historyCleanup.decisionDataCleanup.perDecisionDefinitionConfig
  • historyCleanup.decisionDataCleanup.enabled

Copy link
Member Author

Choose a reason for hiding this comment

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

Oops, there is actually a C8 specific page - system-configuration-platform-8. Is there anything you want to add to that page or can I just remove the C7 one?

Copy link
Contributor

Choose a reason for hiding this comment

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

hmm actually taking a second look, there is some things on there that actually apply to C8. This might require a bit more work to determine what the config page should look like. Probably it can all be a single page now, but it might not be as simple as deleting the others without moving over some fields.

A shallow analysis would be to do this:

  • rename the C8 config page to something generic
  • move over the following properties from the C7 page to the C8 one:
    • import.skipDataAfterNestedDocLimitReached
    • import.elasticsearchJobExecutorThreadCount
    • import.elasticsearchJobExecutorQueueSize*
  • Delete the Event-based process system configuration page

Copy link
Member Author

Choose a reason for hiding this comment

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

For this exercise, I'm going to leave the pages untouched. Can I create a new issue and assign it to you for further triage with your team?

Copy link
Member Author

Choose a reason for hiding this comment

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

@RomanJRW I assigned a docs issue on this topic - #4856. Please feel free to modify and delegate.

@akeller
Copy link
Member Author

akeller commented Jan 8, 2025

@RomanJRW I'll be back to make the changes to this tomorrow. Thank you for your review!

@github-actions github-actions bot temporarily deployed to camunda-docs January 9, 2025 14:53 Destroyed
@akeller akeller marked this pull request as ready for review January 9, 2025 17:46
@akeller
Copy link
Member Author

akeller commented Jan 9, 2025

@RomanJRW I've pulled this out of draft because I think we are super close. I do want to acknowledge there will be some broken links, but in order to stay iterative and keep the PRs relatively small, we should accept this for now.

That said, if this looks good, I would move quickly on the current version docs so we can setup the appropriate (and functional) redirects.

@github-actions github-actions bot temporarily deployed to camunda-docs January 9, 2025 17:59 Destroyed
@RomanJRW
Copy link
Contributor

@akeller

In the preview env I can still see the plugins pages in the sidebar, this should now be deleted but I can't work out what is missing from this PR. I can also still see the C7 migration and update guide. Am I looking in the right place? https://preview.docs.camunda.cloud/pr-4785/docs/next/self-managed/about-self-managed/

@akeller
Copy link
Member Author

akeller commented Jan 10, 2025

@akeller

In the preview env I can still see the plugins pages in the sidebar, this should now be deleted but I can't work out what is missing from this PR. I can also still see the C7 migration and update guide. Am I looking in the right place? https://preview.docs.camunda.cloud/pr-4785/docs/next/self-managed/about-self-managed/

It's a me problem -> I need to remove them from the sidebars file. One sec :)

@github-actions github-actions bot temporarily deployed to camunda-docs January 10, 2025 22:17 Destroyed
@github-actions github-actions bot temporarily deployed to camunda-docs January 10, 2025 22:34 Destroyed
RomanJRW
RomanJRW previously approved these changes Jan 15, 2025
Copy link
Contributor

@RomanJRW RomanJRW left a comment

Choose a reason for hiding this comment

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

Nice, looks really good! Thanks again for doings this.

Two small additional changes that I notice should be done, but otherwise good to go for me. Will pre-approve ✅

@akeller akeller requested a review from RomanJRW January 15, 2025 14:11
@github-actions github-actions bot temporarily deployed to camunda-docs January 15, 2025 14:12 Destroyed
Copy link
Contributor

@RomanJRW RomanJRW left a comment

Choose a reason for hiding this comment

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

It's the most beautiful thing I've ever seen...

🎉

@akeller akeller enabled auto-merge (squash) January 15, 2025 15:29
@akeller
Copy link
Member Author

akeller commented Jan 15, 2025

@RomanJRW @camunda/tech-writers @pepopowitz after this PR merges, I will follow up with action items (issues) for the discussions in this PR and open separate PRs for each previous version. Let's get the Optimize 7 docs out of there 💪

@akeller akeller removed the hold This issue is parked, do not merge. label Jan 15, 2025
@akeller akeller merged commit 16b0f7f into main Jan 15, 2025
9 of 10 checks passed
@akeller akeller deleted the remove-optimize-7 branch January 15, 2025 15:37
@github-actions github-actions bot temporarily deployed to camunda-docs January 15, 2025 15:42 Destroyed
Copy link
Contributor

The preview environment relating to the commit b661de2 has successfully been deployed. You can access it at https://preview.docs.camunda.cloud/pr-4785/index.html

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
component:optimize Issues related with Optimize project deploy Stand up a temporary docs site with this PR
Projects
Status: ✅ Done
Development

Successfully merging this pull request may close these issues.

3 participants