FOSSBilling / fossbilling.org

FOSSBilling website
https://fossbilling.org
Apache License 2.0
12 stars 27 forks source link

Completely rewrite the installation steps #194

Closed BelleNottelling closed 10 months ago

BelleNottelling commented 10 months ago

This was talked about many times over months with at least 1 or two people stating they'd handle it, however I haven't seen any progress and decided I'd get it done. The TLDR of the multiple conversations is that:

The existing docs are too verbose and describe too much. They try to cover the steps for everything from start to finish including setting up a webserver, which isn't something we need to teach people how to do and the existing docs did a very incomplete job of this anyways, meaning we basically shot ourselves in both feet.

To help resolve that I have rewrote, deduplicated, and cleaned up all of the installation steps to:

  1. Eliminate empty & incomplete guides
  2. Remove guides which walked people through the process of manually setting up Apache / NGINX severs from scratch. It's completely out of scope from our docs and it's not our responsibility to teach someone how to perform these actions. If they need help, there's tons of existing guides which are far better than what we'd ever have written.
  3. Consolidates the installations steps guides down to the only real 3 distinct methods (Docker, BoxBilling Migrations, and a standard installation)
  4. Remove or replace info that's outdated or that doesn't match our current standards.
  5. Highlight the aspects of installation that are specific to FOSSBilling which sometimes throw people off and cause them issues.