Galette » Documentation

Johan Cwiklinski a écrit (#note-1):

I'm not against a rework of the page, and it's also OK to put creation database in preparation steps (keep a link from its original location).

But I do not agree with repetitive managed/own/windows entries: most of the steps are exactly the same on all platforms, and using XAMPP or not is just a detail.

I totally agree that the finality of the preparation steps are exactly the same on all platforms.
That is the starting point of my suggested modification :)

But the way to achieve them changes significantly from one use case to another.

I also totally agree that using XAMPP or not is just a detail.

But these are the points of views of the experienced and technical users that we are ! :)

From the point of view of an absolutly non technical user using a managed hosting for the first time, or using XAMPP without knowing what is a webserver or a database - and only because it is required to run galette offline on a windows machine (with all the habits that come along : using *.exe files, click and install, etc.) - I don't think these are just details.

The average reader must get lost with all the warnings, notes, references and configuration examples that generally only interest most advanced users in a self hosted configuration.

Otherwise, starting rewriting the page, I quickly realized that the repetitive entries are not very convenient either to follow the process step by step.
So I've splitted each use case on dedicated pages.
Please have a look at my first draw with the patch attached.

The new structure :

• Prepare installation on a managed hosting
  • Setup the webserver
  • Create the database
  • Copy files and set permissions on the webserver
  • Serve Galette to the web
  • Secure Galette
• Prepare installation on a self hosting
  • Setup the webserver
  • Create the database
  • Copy files and set permissions on the webserver
  • Serve Galette to the web or your local network
  • Secure Galette
• Prepare installation on XAMPP
  • Setup the webserver
  • Create the database
  • Copy files and set permissions on the webserver
  • Serve Galette to your local network
  • Secure Galette
  • Additional step : configure XAMPP to send emails

What do you plan to can put in "Setup the webserver"?

• managed hosting : mainly, I tell that this part is managed by the hosting providers, and that nothing needs to be done in this case except checking that the hosting plan fits the required PHP version for Galette (and tell the user that the version of PHP can generally be modified from the hosting customer account).
• self hosting : commands to install webserver, database and php
• XAMPP : install XAMPP

Same question for "Secure Galette".

I'll move there the recommandations about the config and install directories after install. And :

• managed hosting : enable SSL certificate on the hosting provider customer account, enable https and set apache security headers in .htaccess.
• self hosting : Let's encrypt, https by default and security headers in the vhost conf (apache and nginx).
• XAMPP : use self signed certificate, and tell the readers it is not the most secured and convenient solution to put galette online. If used offline, nothing to be done really.

I took a look at your patch, and I'm still not convinced by the TOC. I'd like to propose an alternative one; but this is not a priority for me right now - even if the doc is really perfectible, it does exists, and many users already have installed Galette using it ;)

Also, I'm going to officially release 0.9.5/0.9.5.1; that kind of rewrite will break all existing translations so it won't be merged to the develop branch before that.

So, I postpone that subject for now; and I'll try to propose an alternative solution.

Appliqué par commit b990a7f95b46c5f5631e5f7dcb8824fa5cf7cab3.