CT-2209 improve readme

[jirkasemmler]

Changes:

• reorganize readme by topics

• add instructions for development/usage

• let AI generate docs for missing commands

---

Additional notes

⚠️ Don't forget to release new version after merge

[vojtabiberle]

Running locally

1. clone the repo
2. (optional for manage:mass-project-remove-expiration) init .env file cp .env.dist .env and fill variables
3. build the image docker compose build app
4. run a command docker compose run --rm app <command>

Development

1. clone the repo
2. (optional for manage:mass-project-remove-expiration) init .env file cp .env.dist .env and fill variables
3. build the image docker compose build dev
4. update the code
5. run a command docker compose run --rm dev <command> (run composer install for you automaticaly)

---

I think we should use docker compose when we have this setup done and do not mess with lover docker command

[vojtabiberle]

you don't even need php cli.php in front of command as running cli.php is part of docker compose setup

[jirkasemmler]

• I have added the .env to app service (otherwise it would be ignored) -> so the .env file is required -> added to the steps
• the php cli.php is needed because we don't have entrypoint but command in docker-compose.yml
• I have split the running locally and development as you suggest, good point
• I still would keep the docker run for cases when you dont want to build the image locally (which you technically should not, if you simply want to use it as is)

[jirkasemmler]

@vojtabiberle I have made some modifications, thats why the new review requested

[vojtabiberle]

looks OK for me