Documentation changes with the new user in mind

[michael-valdron]

/kind user-story /kind epic

Which area this user story is related to?

/area documentation

User Story

As a new user to devfiles, I would like to see documentation which gives the a clear practical introduction to setting up the spec for my development environment, so that I obtain the understanding needed to continue using devfiles and the supporting developer tools as my choice for developing Kubernetes applications and services.

To meet these requirements, additions and revisions to our doc pages are needed to create a new user friendly experience.

Acceptance Criteria

• [x] https://github.com/devfile/api/issues/1057
• [x] https://github.com/devfile/api/issues/1079
• [ ] https://github.com/devfile/api/issues/1035
• [ ] https://github.com/devfile/api/issues/885
• [x] https://github.com/devfile/api/issues/886
• [x] https://github.com/devfile/api/issues/744
• [x] https://github.com/devfile/api/issues/1076
• [ ] https://github.com/devfile/api/issues/913
• [ ] https://github.com/devfile/api/issues/1074
• [x] https://github.com/devfile/api/issues/1090
• [ ] https://github.com/devfile/api/issues/1101

[michael-valdron]

Good part of this should close https://github.com/devfile/api/issues/424.

[michael-valdron]

Adding #885 to this epic due to it being a blocker to the epic item #886.

[michael-valdron]

This epic is out of sprint so I will move this into backlog.

[github-actions[bot]]

This issue is stale because it has been open for 90 days with no activity. Remove stale label or comment or this will be closed in 60 days.