[Docs] Reorganize the "Topic guides" section

[LoicPoullain]

Goal

Make the docs more readable and complete and anticipate the documentation of the future features.

Possible new structure of the "Topic guides" section

Items in italic have not been written yet (even partially).

Architecture

• Architecture Overview
• Controllers
• Services & Dependency Injection
• Hooks

Databases

• TypeORM (SQL & noSQL)
• Create Models & Queries
• Generate & Run Migrations
• Mongoose (MondoDB) -> https://github.com/FoalTS/foal/issues/277

Authentication & Access Control

• Introduction
• User Entity & create-user Script
• Session & Cookie (authentication)
• JWT (authentication) -> https://github.com/FoalTS/foal/issues/254
• Password management
• Administrators & Roles
• Groups & Permissions
• OAuth2 (Google, Twitter, etc) -> https://github.com/FoalTS/foal/issues/125

Validation

API

• REST blueprints -> https://github.com/FoalTS/foal/issues/278
• REST controllers (deprecated) -> deprecated in v0.7.0
• OpenAPI & Swagger UI -> https://github.com/FoalTS/foal/issues/276
• Public API & CORS requests
• GraphQL -> https://github.com/FoalTS/foal/issues/126

Frontend integration

• SPA
• Angular, React & Vue -> https://github.com/FoalTS/foal/issues/279, https://github.com/FoalTS/foal/issues/258, https://github.com/FoalTS/foal/issues/258

CLI & Development Environment

• Build & Start the App
• Create & Run Scripts
• Code Generation
• Linting & Code Style
• VS Code
• Running jobs

Testing

• Introduction
• Unit Testing
• E2E Testing

Security

• HTTP headers protection (helmet)
• CSRF Protection
• XSS Protection

Utilities

• Templating
• Logging & Debugging

Cookbook

• 404 Page

Deployment & Environments

• Configuration
• Ship to Production

[LoicPoullain]

The E2E Testing page should also have examples on how to test controllers that require authentication (with jwt or sessions and cookies).

[LoicPoullain]

Section reorganized in v0.7.0