No offense, but the same applies for typing the part with the remarks to that topic.
Stunning, thanks for your trust in us and our project.
In fact we do accept pull requests and change suggestions if they make sense and do cover the broad user base.
Okay two things.
Discourse closes stale topics automatically without a chance to adjust that as of now.
This community board is community driven. The Zammad team tries to answer and help on issues if in application scope and the time allows it. This is not always possible I’m afraid. Nobody ever guruanteed solutions for everything on here.
Still, I got you covered:
https://github.com/zammad/zammad-documentation/tree/mh/rework/installation-documentation
There’s a rework of the installation docs going on. It takes time though.
Now to your points.
Yes and no.
This is a configuration specific issue. The documentation, except for the last sentence “go to localhost blah” aims for a public reachable Zammad instance. This means that your setup just might not fit the described use case that the documentation aims for. This is the part the “broad userbase” comes back in. We can’t fit any little detail. We also can’t cover everyone.
I’m very sorry for that, but you can’t always expect the “I get everything package” for giving nothing back. Please don’t get me wrong here. It’s just impossible to cover everyones needs and requirements.
I can’t reproduce that.
The documentation is tested against default installations of each system we do list and cover.
Your two above points do not happen in my enviroments. I do regulary test and re-test installation steps and ensure that they are working. That is part of my many duties. While I do agree that the installation documentation is not ideal and an ugly desaster in terms of “grown things”, this is something that takes time. If you’re working alone on such big documentationary that we do provide you’ll have to have grey spots etc.
I’m sorry that those do cover you - but that’s something clear feedback or maybe even a pull request can cover. The posts you mention are not always covering the same directions, this is why saying “we have plenty of those and they’re all unanswered” are not a benchmark.
I’m currently behind up to 16 days - and will take my next week off to cool down on this topic.
Have a nice weekend.