Skip to content

README.md

Latest commit

 

History

History
58 lines (36 loc) · 3.06 KB

README.md

File metadata and controls

58 lines (36 loc) · 3.06 KB

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 form in its current state, for example this pre-filled form

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

Discussion

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

Content Management and Translations

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

  • questions-en.yaml - English (default language)
  • questions-[lang].yaml - Translations

To add a language, add the YAML file and add the language to the list 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. Verify consistency: Ensure all three files have:
    • Same category IDs and structure
    • Same question IDs within each category
    • Same option values (1-5) for scoring consistency
    • Translated text for all user-facing content

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=zh, ?lang=es
  2. Verify all text displays correctly
  3. Ensure functionality works across all languages
  4. Test the complete assessment flow in each language