The Developer Experience Workshop focuses on user-centered design in platform engineering. It introduces the concept of Platform Teams that support Stream-Aligned Teams, aiming to reduce the cognitive load of developing and maintaining applications, and highlights the importance of understanding developers' needs for efficient platform creation. The workshop emphasizes good Developer Experience (DX) characterized by clear documentation, intuitive API design, precise error messages, and efficient tools, alongside the use of User Personas to represent typical user characteristics, needs, and behaviors, providing a shared understanding and empathy towards users.
Contained in the folder workshop-resource are sample portraits of User Personas and a list of features that can be used to make creation of User Personas less time-consuming. I recommend using these in conjunction with real user research to create User Personas for your own platform. Start by discussing possible User groups and then split into groups of 2-3 people to create User Personas for each group. Afterwards, present your User Personas to the other groups and discuss similarities and differences.
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.
You will need to have the following tools installed on your machine.
-
Node.js and npm
- Visit the official page to download and install Node.js and npm
-
Git
- Visit the official page to download and install Git
-
Visual Studio Code (VS Code)
- Visit the official page to download and install Visual Studio Code
Follow these steps to get the project running:
-
Clone the repository to your local machine
git clone https://gitlab.rewe.local/gitops/poc/architekturentschiedung-fuer-neue-kubernetes-plattform.git
-
Navigate into the project directory
cd architekturentschiedung-fuer-neue-kubernetes-plattform
-
Install MARP CLI globally
npm install -g @marp-team/marp-cli
Alternatively install MARP CLI using brew
brew install marp-cli
-
Install the Marp for VS Code extension:
- Open VS Code
- Go to the Extensions view (⇧⌘X)
- Search for
marp
and install Marp for VS Code
Once you have the project up and running, you can render the markdown file to a slideshow by running:
marp kubernetes-platformen.md
This command will create a kubernetes-platformen.html
file that you can open in a web browser to view the slideshow.