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

Create a FAQ document for Sealed Secrets public documentation #1269

Merged
merged 6 commits into from
Jul 13, 2023

Conversation

agarcia-oss
Copy link
Member

@agarcia-oss agarcia-oss commented Jul 11, 2023

Description of the change

The Sealed Secrets public site needs a new page for frequently asked questions. This page will replace the current entry in the README file.

Unrelated, the PR also includes a TOC section in the cryptography document

Signed-off-by: Alfredo Garcia <algarcia@vmware.com>
If you do want to make a backup of the encryption private keys, it's easy to do from an account with suitable access:

```console
$ kubectl get secret -n kube-system -l sealedsecrets.bitnami.com/sealed-secrets-key -o yaml >main.key
Copy link
Collaborator

Choose a reason for hiding this comment

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

Are we choosing to use leading $ for commands or not? I see uses of both alternatives.

Copy link
Member Author

@agarcia-oss agarcia-oss Jul 12, 2023

Choose a reason for hiding this comment

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

I think the general rule is to use

  • shell when we show only the command (and no $)
  • console when showing the command and it's return values (and then use the $ to make it clear what's a command and what's a result)

Copy link
Collaborator

Choose a reason for hiding this comment

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

We don't seem to be following that convention in these files, we should fix that.

Copy link
Collaborator

Choose a reason for hiding this comment

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

I guess this one should be shell as it has no outputs

Signed-off-by: Alfredo Garcia <algarcia@vmware.com>
Signed-off-by: Alfredo Garcia <algarcia@vmware.com>
Signed-off-by: Alfredo Garcia <algarcia@vmware.com>
agarcia-oss and others added 2 commits July 13, 2023 09:31
Apply suggestion

Co-authored-by: Alejandro Moreno <amorenoc@vmware.com>
Signed-off-by: Alfredo Garcia <algarcia@vmware.com>
Apply suggestion

Co-authored-by: Alvaro Neira Ayuso <alvaroneay@gmail.com>
Signed-off-by: Alfredo Garcia <algarcia@vmware.com>
Copy link
Collaborator

@alvneiayu alvneiayu left a comment

Choose a reason for hiding this comment

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

LGTM

@agarcia-oss agarcia-oss merged commit c879326 into bitnami-labs:main Jul 13, 2023
16 checks passed
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.

3 participants