Hard to get this project up and running for new users

[WilliamDEdwards]

• The admin guides at https://oncall.tools/docs/admin_guide.html and https://github.com/linkedin/oncall/blob/master/docs/source/admin_guide.rst have diverged. The first one tells users to navigate to ops/packer, which was removed in 5cd0f0c
  • README.md points to the outdated guide (https://github.com/linkedin/oncall?tab=readme-ov-file#oncall--)
• The 'Local machine' development setup (https://github.com/linkedin/oncall?tab=readme-ov-file#local-machine) tells users to install python-pip python-setuptools mysql-server mysql-client, which no longer exist on new Debian releases. python3-pip python3-setuptools mariadb-server mariadb-client do.
  • Is up-to-date in the Dockerfile, but that's because Docker container support was added during the Python 3 upgrade (Py3 #290)
• MySQL 5.7 (https://github.com/linkedin/oncall/blob/master/docker-compose.yml#L19) is extremely outdated. It's unclear whether newer versions and/or MariaDB are supported.
• I want to use this project without Iris, but there is no indication that IRIS_API_HOST is optional (https://github.com/linkedin/oncall/blob/master/docker-compose.yml#L11) without looking in the code (

  oncall/src/oncall/app.py

  Line 135 in 9bc2b68

  os.environ.get("IRIS_API_HOST", config.get('iris_plan_integration', {}).get('api_host', ''))))

  )
  • It might be unclear to new users what Iris even is, and whether these projects must or may be used in conjunction.
• This project uses the deprecated setup.py instead of pyproject.toml (which makes it harder to make a Debian package out of it).
• Python 3.13, and therefore Debian Trixie, are not supported (Python support > 3.10 #431 (comment))
  • No supported Python versions are documented.