Doc restructuration

[benoitblanc]

Hi,

As I mentionned in issue #5 , I would like to help to enhance the documentation.

In this first PR, I propose to restructure documentation by creating different sections :

• Overview : part of README in https://github.com/qwc-services/qwc-docker
• Installation : READMEs from qwc-services repos, qwc2-demo-app doc, quick-start from part of https://github.com/qwc-services/qwc-docker README
• User Guide : docs to be created in repos to present features and how to use it
• Administration Guide : docs to be created (essentially for qwc-admin-gui, and how to configure project in QGIS ?)
• How to : some tricks to enable features by configuring QGS project or specific service

For now, there is only Installation section because READMEs of qwc-services contain installation/deployment/configuration instrucitons.

Then, we could add more docs on repos for User guide and Administration guide and pull it to this documentation.

What do you think about it ?

Thanks

[pka]

I'm fine with your ideas. Just thinking about wording. I slightly prefer "setup" over "installation" and maybe "Knowledge Base" instead of "How to"?

Thanks a lot for improving the Makefile! We can also merge and rename things afterwards.

[pka]

Is the title not required?

[benoitblanc]

No, with Hugo-theme-learn you can define menuTitle that will be used in page's menu entry.

You don't need to define title (not required in Hugo) because it will be retrieved from all READMEs (in Makefile), so we don't need to remove duplicate title as in commit 06145f023a735e42193c6fdc15c50cfaa50573d7 when we just want to update documentation.

[benoitblanc]

@pka I have renamed Installation to Setup.

As other sections (How to, User guide, Admin guide) are not already created, we could rename with the right wording when it will be created 👍