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 decent user experience for operators of candidate subjects for certification #212

Open
martinmo opened this issue Jul 11, 2024 · 2 comments
Assignees
Labels
epic Issues that are spread across multiple sprints SCS is standardized SCS is standardized SCS is understandable SCS is understandable SCS-VP10 Related to tender lot SCS-VP10
Milestone

Comments

@martinmo
Copy link
Member

martinmo commented Jul 11, 2024

(Disclaimer: issue title is not perfect, I know...)

Problem: at the moment, you have to dig to find out what you need to do to become KaaS or IaaS certified. The information is there, but it is distributed and not easy to find.

For example, going from the scs.community homepage:

  • first click "Documentation" (there is not top level "Standards" link)
  • go to "Standards" -> "Certification"
    • some people might not even get here, because they except this kind of information under "For Operators" ?
  • in the section "Becoming certified" you'll get directed to "Regulations for achieving SCS-compatible certification", which is itself a standard.
  • regulation no. 2 has a link to the /Tests directory in the standards repository
    • the README has all infos, but it is way too technical

This should be improved:

  • The "Standards" page could have better visibility on its own (e.g., in "Discover SCS" or next to "Documentation" on the SCS landing page).
  • Make "How to become certified" a top level menu entry on the "Standards" page (and maybe also on the "For Operators" page?)
    • using the reference implementation? -> you're already good
    • using sth else? -> collection of links to implementation notes, guides, blog posts
  • Include an easy to follow step-by-step guide for the IaaS and KaaS conformance checks against a cloud.

UPDATE: There are some recent improvements (new implementation notes) in the standards repository which should be considered: SovereignCloudStack/standards#631 (already merged) and SovereignCloudStack/standards#643 (work in progress).

@martinmo martinmo added SCS is standardized SCS is standardized SCS is understandable SCS is understandable SCS-VP10 Related to tender lot SCS-VP10 labels Jul 11, 2024
@martinmo martinmo self-assigned this Jul 11, 2024
@fkr
Copy link
Member

fkr commented Jul 11, 2024

Indeed very good. In the sense of diataxis, this would be the format of a how-to guide.

@mbuechse mbuechse self-assigned this Aug 14, 2024
@mbuechse mbuechse added this to the R7 (v8.0.0) milestone Aug 14, 2024
@mbuechse mbuechse changed the title Make information about how to become certified and run conformance tests more accessible Create decent user experience for operators of candidate subjects for certification Aug 14, 2024
@mbuechse mbuechse added the epic Issues that are spread across multiple sprints label Aug 14, 2024
@mbuechse
Copy link
Contributor

Processes shall be made "fool-proof". That is, it should be really simple to obtain the first report on the candidate subject, and the report should ideally be actionable as far as possible (it need not be an executable shell script 😉). Thanks to input from @neuroserve.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
epic Issues that are spread across multiple sprints SCS is standardized SCS is standardized SCS is understandable SCS is understandable SCS-VP10 Related to tender lot SCS-VP10
Projects
Status: Backlog
Development

No branches or pull requests

3 participants