cuba-platform / documentation

CUBA Platform Documentation
https://www.cuba-platform.com
Creative Commons Attribution 4.0 International
26 stars 45 forks source link

Summary Page for Quick Start #677

Closed mariodavid closed 4 years ago

mariodavid commented 4 years ago

Environment

Summary Page

At the end of going through the quick start subpart of the documentation, the user is a little left alone on what to do next. Currently, the resulting screen promotes going down the documentation details, where it becomes very technical: https://doc.cuba-platform.com/manual-7.2/qs_run.html

Bildschirmfoto 2020-04-01 um 07 19 37

It would be good to have a quick "Summary" section / Sub Page, that would summarize what just happened by mentioning all important points of the Quickstart once again. Then the user should be guided into where to go next.

Cross Links to other resources

What would be better is to provide the user options on which learning routes they would like to go into. Cross Links to the Learn Section with all its Videos, Guides and running example applications might be as valuable for the user as the "Framework" section of the documentation.

Those links can e.g. be made in a non-intrusive manner by providing side information on the right of the actual text like this:

documentation-home-with-right-tiles

In this case, the screenshot shows an example of the Documentation homepage, but the same pattern can be applied on the end of the Quickstart section.