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

Separate hidden and non-hidden commands in lakectl docs #8204

Merged
merged 2 commits into from
Oct 6, 2024

Conversation

arielshaqed
Copy link
Contributor

Also add a scary banner so people know not to use them.

Closes #5437.

@arielshaqed arielshaqed added area/lakectl Issues related to lakeFS' command line interface (lakectl) docs Improvements or additions to documentation include-changelog PR description should be included in next release changelog labels Sep 22, 2024
Copy link

github-actions bot commented Sep 22, 2024

♻️ PR Preview 06ab8ef has been successfully destroyed since this PR has been closed.

🤖 By surge-preview

Copy link

E2E Test Results - DynamoDB Local - Local Block Adapter

13 passed

Copy link

E2E Test Results - Quickstart

10 passed

@arielshaqed arielshaqed force-pushed the docs/5437-separate-hidden-commands-in-docs branch from a0ee024 to 06ab8ef Compare September 22, 2024 09:51
@arielshaqed
Copy link
Contributor Author

("Draft" to decide that this is our preferred solution.)

Copy link
Contributor

@itaigilo itaigilo left a comment

Choose a reason for hiding this comment

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

Looking good in general -
I'd be happy for another person to TAL at this.

var cliReferenceHiddenCommandsSeparator = `
-------

## Undocumented commands
Copy link
Contributor

Choose a reason for hiding this comment

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

A thought:
This section is pretty much at the top of the file, so it pretty much pops up.
If it can be pushed to the bottom of the file, might be nicer I think…

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Not sure, could you explain on the auto-generated CLI reference file in this PR where things should go?

Copy link
Contributor

Choose a reason for hiding this comment

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

Well, I can't think of another option actually...

@arielshaqed arielshaqed marked this pull request as ready for review September 26, 2024 06:00
Copy link
Contributor Author

@arielshaqed arielshaqed left a comment

Choose a reason for hiding this comment

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

Reminder: you can view changes here.

@arielshaqed
Copy link
Contributor Author

Skipping @ozkatz' review and merging - as I believe this is an improvement. I will of course roll back if needed!

@arielshaqed arielshaqed merged commit 1837eff into master Oct 6, 2024
37 of 38 checks passed
@arielshaqed arielshaqed deleted the docs/5437-separate-hidden-commands-in-docs branch October 6, 2024 07:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/lakectl Issues related to lakeFS' command line interface (lakectl) docs Improvements or additions to documentation include-changelog PR description should be included in next release changelog
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Hidden commands in Docs
2 participants