Skip to content

About

No description, website, or topics provided.

Resources

Stars

15 stars

Watchers

2 watching

Forks

Repository files navigation

Platform maturity assessment

This repo contains the Platform Maturity Model Assessment.

On answering the questions you get a spider diagram and a matrix to indicate where you are on a map right now.

You can copy the URL to share the assessment in whatever state it is in. For example:

Alongside the answers, v records which version of the question set they were given against, page records which page was open, and view=results opens straight to the results.

When giving feedback please use these shareable URLs to help folks see what you see.

Note: If you switch the language while viewing the results, the app will keep you on the results page and re-render them in the selected language. Shareable links from the results page also include this view so recipients land directly on the results.

A screenshot showing the questions A screenshot showing the assessment results, a spider chart, heatmap matrix, and list of scores

Versioning

The assessment question set carries its own version, separate from the repository's release tags, because the field_name keys and option values in shareable links are a public contract: renaming or renumbering a question silently changes what previously shared links mean.

Shareable links therefore include a v parameter recording the question set they were built against, and the footer shows the current assessment version alongside the CNCF Platform Engineering Maturity Model release it is based on.

Before changing anything under data/, read VERSIONING.md, which has the bump rules and the release process. You can check your changes locally with:

python3 scripts/validate_content.py

See CHANGELOG.md for release history.

Discussion

Please join the Cloud Native Computing Foundation on Slack and use the platform-engineering channel.

Content Management and Translations

The assessment content is managed through YAML files in the /data/ directory for easy updates and translations:

  • questions-en.yaml - English (source of truth)
  • questions-[lang].yaml - Translations, currently ja, pt and zh
  • quarantine/ - Translations that are incomplete or not yet reviewed, excluded from the site

To add a language, add the YAML file and add a link for it to the language nav in index.html.

Updating Questions and Content

⚠️ IMPORTANT: When updating questions-en.yaml, you MUST also update the corresponding translations:

  1. Make changes to the English source file first: Edit data/questions-en.yaml

  2. Update translation: Apply equivalent changes to data/questions-[lang].yaml

  3. Bump the version: Follow the rules in VERSIONING.md

  4. Verify consistency: Run python3 scripts/validate_content.py, which checks that every file has:

    • Same category IDs and structure
    • Same question IDs within each category
    • Same option values (1-4) for scoring consistency

    It compares structure only, and cannot tell whether the text was actually translated. Check that by eye.

What Needs Translation

When updating content, ensure these elements are translated in all language files:

  • metadata section (titles, messages, UI text)
  • Category name fields
  • Question text content
  • Option level and description text

Testing Translations

After updating translations:

  1. Test each language using URL parameters: ?lang=en, ?lang=ja, ?lang=pt, ?lang=zh
  2. Verify all text displays correctly
  3. Ensure functionality works across all languages
  4. Test the complete assessment flow in each language

About

No description, website, or topics provided.

Resources

Stars

15 stars

Watchers

2 watching

Forks

Releases

Packages

Contributors

Languages