-
Notifications
You must be signed in to change notification settings - Fork 72
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
Combine sigstore FAQs into one FAQ /check links and help page #176
Comments
@haydentherapper @olivekl @ltagliaferri Discussion of FAQ on sigstore-website I'm trying to coordinate the FAQs between sigstore-website and sigstore-docs. So far I think we need to keep an FAQ for the sigstore-website, but move some of the questions over to an FAQ on the docs side. So I think the following would be a good set to keep on the website, and move the rest over to docs: Keeping on website: Moving to docs: I'm planning on moving all the FAQs together and put headers on them so that they are more easily found, as they currently are all over the place. Question regarding sigstore-website, does anyone keep this updated? It appears to not have been touched in a year and a half. Anyway, any comments or suggestions regarding this part of the task would be helpful. Thanks! |
Thanks for this! A few minor points on the questions: "Is there live support?" -- I think this makes sense to leave on the website Happy to hear thoughts from @haydentherapper @ltagliaferri on these suggestions! |
Agreed to dropping "are there any privacy issues". "Why not blockchain" - I'd lean towards dropping. It requires a deeper level of understanding about how blockchain works vs a transparency log. It's not a bad topic to touch on, but we would need to flesh this out more. |
By dropping you mean getting rid of completely? |
Yup! I don't think those two are actually that relevant or questions that are frequently asked. |
I would rephrase the TUF question to be something like this:
Just because it sounds like you may be addressing both the "use" and "interact with" portions of the original question. The sigstore-website repo was last updated two weeks ago. If you want to open a PR there, I can review and merge. It is not a big priority across contributors because it is more of a "showcase" site I believe, and the blog is contained in sigstore-blog. |
On another subject dealing with this issue, I want to combine all the Sigstore-docs FAQs along with the general FAQs into one FAQ under the Help section. Each of the current FAQs (one for cosign, fulcio, rekor, and general from sigsore-website that gets pulled out as discussed above) would go into this new FAQ. The FAQ will have headers for each of these topics (again: cosign, fulcio,rekor,general) and have the current questions answered there. Anyone have thoughts on this plan? |
Description
There are several FAQs under https://docs.sigstore.dev/ They should be combined into one FAQ with headers for different sections and be placed under the help header.
All links in sigstore docs should be checked to see if they currently work and go to a reasonable location.
Help page maintainers should be checked to see if they are still accurate.
The text was updated successfully, but these errors were encountered: