Skip to content

Landing page for devfile website #379

@elsony

Description

@elsony

The existing documentation is more spec-focused. We need a landing page that helps to promote devfile and let the user buy-in to adopt devfiles and use them in their day-to-day development.

The landing page will answer the following questions:

  1. What is devfile?
  2. What is the existing problem that different persona is facing, e.g. application developer, runtime providers, architect?
  3. Benefits of devfile
  4. How does it fit into the full development cycle, e.g. local, then container, then k8s, inner-loop to outer-loop, etc.

Then, the landing page will branch off to 4 main personas and provide the information targeted for each of them with samples and best practices:

  1. application developer
  2. runtime providers
  3. registry admin
  4. tools provider

Note: example of best practices include (depending on the persona):

  1. How to limit resources
  2. What are the things I should put in my devfiles
  3. What are the things I should not put in my devfiles
  4. How to work with devfiles along with application development’s lifecycle

Metadata

Metadata

Assignees

Labels

area/documentationImprovements or additions to documentationhelp wantedExtra attention is neededkind/enhancementNew feature or requestseverity/P2Issues that have a major impactstudentIdentified work that the students can work on

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions