Overview

Developer Portal supports the creation of dynamic product canvas using markdown and allows the user to easily write their strategy and see it come to life in a sleek, slide-like format. This post provides a walkthrough of various product canvases supported by Developer Portal and guides the user to prepare the markdown files to ensure they are picked up and beautifully rendered in the LiveDoc report.

Why use Markdown for Product Canvas?

Markdown is a lightweight and easy-to-use syntax which will allow the product stakeholders to

Maintain focus: Concentrate on the content without getting distracted by the complex design tools.
Stay organised: Structure the thoughts in a consistent format, making it easy to communicate the product vision.
Effortessly update: Simply edit the markdown file whenever priorities change and automatically generate the updated product canvas.

Available canvas types

Vision canvas
- Captures the strategic vision of the product or initiative
- Helps to communicate the long-term goals and purpose clearly
- Download a sample
Value Proposition canvas
- Defines customer needs, pain points and product benefits
- Focus on aligning the product offering with customer expectations
- Download a sample
Roadmap Release canvas
- Organises the features and initiatives under
  - Run: Maintain and support existing features
  - Grow: Enhance and expand product capabilities
  - Transform: Innovate and introduce breakthrough features
  - Milestone: Track key achievements and deadlines
- Download a sample
Metrics OKRs canvas
- Set and track ‘Objectives’ and ‘Key Results’
- Keep teams aligned and focused on measurable outcomes
- Download a sample

Getting started

Create a folder named ‘canvas’ in the Github repository of the product. This folder will contain all the canvas files that need to render in the LiveDoc report.
Create a canvas file in markdown format and should include the following attributes in the front matter.
- canvas-type - This specifies the type of product canvas and can have one of the following values.
  - value-proposition
  - roadmap-release
  - value-canvas
- title - The title specified in the product canvas appears in the LiveDoc report.
Log into Developer Portal and generate the LiveDoc report.

Need more support?

You can find detailed information on how LiveDoc is generated here.