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 most mentions of Core license from docs #19001

Merged
merged 6 commits into from
Oct 17, 2024

Conversation

rmloveland
Copy link
Contributor

Addresses DOC-10665

Summary of changes:

  • Review and remove all mentions of Core license from docs, with the following exceptions (which will be later work):

    • Licensing FAQs page, which will be updated via DOC-11203

    • Mentions of Core Changefeeds, about which the method of removal from docs is TBD

Copy link

github-actions bot commented Oct 10, 2024

Files changed:

Copy link

netlify bot commented Oct 10, 2024

Deploy Preview for cockroachdb-api-docs canceled.

Name Link
🔨 Latest commit 0418c3a
🔍 Latest deploy log https://app.netlify.com/sites/cockroachdb-api-docs/deploys/6711273ae8051f00083560ae

Copy link

netlify bot commented Oct 10, 2024

Deploy Preview for cockroachdb-interactivetutorials-docs canceled.

Name Link
🔨 Latest commit 0418c3a
🔍 Latest deploy log https://app.netlify.com/sites/cockroachdb-interactivetutorials-docs/deploys/6711273aa303a80008b90db1

@rmloveland rmloveland force-pushed the 20241009-DOC-10665-remove-mention-of-core-license branch from b846378 to 7e276d6 Compare October 10, 2024 14:49
Copy link

netlify bot commented Oct 10, 2024

Netlify Preview

Name Link
🔨 Latest commit b846378
🔍 Latest deploy log https://app.netlify.com/sites/cockroachdb-docs/deploys/6707e7d66af01300083ca83a
😎 Deploy Preview https://deploy-preview-19001--cockroachdb-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

Copy link

netlify bot commented Oct 10, 2024

Netlify Preview

Name Link
🔨 Latest commit 0418c3a
🔍 Latest deploy log https://app.netlify.com/sites/cockroachdb-docs/deploys/6711273a11136e000899e4a7
😎 Deploy Preview https://deploy-preview-19001--cockroachdb-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@rmloveland
Copy link
Contributor Author

@kathancox can you please look at my (hopefully minimal) changes to the backup docs in this PR? to make sure i'm not making a huge mess in your product area? 🙇

also as noted in the description i have completely left out core changefeeds while we work towards a decision there -

@taroface for you this is a general review request pls 🫡

ofc feel free to opine on the backup changes as well from a writerly POV

Copy link
Contributor

@kathancox kathancox left a comment

Choose a reason for hiding this comment

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

Few comments, not sure if it is necessary to remove references of "This is an Enterprise-only feature".. if we do need to. Each of the Backup feature pages, like locality aware, encrypted etc. include a note saying this. Also, instances like this: https://www.cockroachlabs.com/docs/v24.2/backup-and-restore-overview#backup-and-restore-support (I'm not sure if the third column needs to change.)

And, instances like this "You do not need an Enterprise license to run any of the backup validation tools described on this page."

Let me know if there is anything I can do here to help. Also, I've sent a message out re Core changefeeds, will keep you up to date.

src/current/v24.3/backup.md Outdated Show resolved Hide resolved
Copy link
Contributor

@taroface taroface left a comment

Choose a reason for hiding this comment

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

Blocking here mostly for the Dedicated mention that slipped through. I have a longer comment on a separate change; sorry if you already have an upcoming plan for the things I raised! Otherwise I can raise it in Slack.

src/current/v24.3/security-reference/security-overview.md Outdated Show resolved Hide resolved
src/current/v24.3/sso-sql.md Outdated Show resolved Hide resolved
src/current/v24.3/ui-overview.md Outdated Show resolved Hide resolved
@rmloveland
Copy link
Contributor Author

rmloveland commented Oct 15, 2024

Few comments, not sure if it is necessary to remove references of "This is an Enterprise-only feature".. if we do need to. Each of the Backup feature pages, like locality aware, encrypted etc. include a note saying this. Also, instances like this: https://www.cockroachlabs.com/docs/v24.2/backup-and-restore-overview#backup-and-restore-support (I'm not sure if the third column needs to change.)

thanks @kathancox ! I have upscoped this PR to remove (almost) all such mentions of enterprise-only this and that. Basically 99% of things that link to enterprise-licensing.md are now removed - the few that remain will be removed when I complete #19002 which will follow this

there's a lot of changed files but the changes are mostly trivial deletions of sentences like "This is an Enterprise feature [LINK]" etc.

And, instances like this "You do not need an Enterprise license to run any of the backup validation tools described on this page."

Removed all of those as well!

Let me know if there is anything I can do here to help. Also, I've sent a message out re Core changefeeds, will keep you up to date.

awesome thanks! PTAL at the latest commit called Update with kathancox feedback (1) which includes updates based on all of your feedback

Addresses DOC-10665

Summary of changes:

- Review and remove all mentions of Core license from docs, with the
  following exceptions (which will be later work):

  - Licensing FAQs page, which will be updated via DOC-11203

  - Mentions of Core Changefeeds, about which the method of removal from
    docs is TBD
@rmloveland rmloveland force-pushed the 20241009-DOC-10665-remove-mention-of-core-license branch from 816dab6 to 6bad1ba Compare October 15, 2024 19:50
@rmloveland
Copy link
Contributor Author

Blocking here mostly for the Dedicated mention that slipped through. I have a longer comment on a separate change; sorry if you already have an upcoming plan for the things I raised! Otherwise I can raise it in Slack.

Thanks @taroface ! I have addressed your specific changes in the commit Update with taroface feedback (1) - PTAL!

Re: the longer comment on a separate change / stuff we discussed in Slack earlier this week, I would like to address all those things too but I think for this specific "core deprecation" work those improvements will have to happen separately

Copy link
Contributor

@taroface taroface left a comment

Choose a reason for hiding this comment

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

LGTM, just a minor suggestion!

@rmloveland
Copy link
Contributor Author

@jaiayu FYI this is the "remove mention of Core and Enterprise from docs" PR I mentioned in today's weekly FYI

it does not talk about the new licensing, rather, it's the "rip out ~all the Core / Enterprise mentions" kind of pre-work PR

Copy link
Contributor

@mdlinville mdlinville left a comment

Choose a reason for hiding this comment

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

Since I was mentioned, I took a look at the includes and pages for deployment (install, orchestration, start commands, etc) and security / authentication, and they look great to me. Thank you so much. (the build failure is a handful of newly-broken anchors)

@rmloveland
Copy link
Contributor Author

synced with @kathancox offline and she's good with this merging

i will now fix a couple broken anchors and merge

@rmloveland rmloveland enabled auto-merge (squash) October 17, 2024 15:04
@rmloveland rmloveland merged commit 5df409b into main Oct 17, 2024
7 checks passed
@rmloveland rmloveland deleted the 20241009-DOC-10665-remove-mention-of-core-license branch October 17, 2024 15:10
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