I apologize for the wall of text, but I wanted to thoroughly explain my choices and reasoning for this docker-compose.yml. I hope you find it useful.
I am working on writing up some quality help/instructions for Lemmy instance admins. This is targeted toward those that are newer to Lemmy and Docker, but even those that know a thing or two might learn something from me. I have been a sysadmin for over 20 years, so I know some things.
I thought I'd share the first complete page I have written. I'd love some feedback if you have any to share.
I was expecting your document to be some kind of tutorial, but it seems like you wrote it for people who already know what they're doing. I would need to understand the "normal" way of doing it first before I would be able to understand what you're talking about in your document. (Note: I'm new to Docker, which is why I gave up on setting up my own Lemmy server. It would be nice if someone could write a tutorial specifically for people who are new to Docker.)
If you want to help people set up their instances, I don't think your document should have so much focus on the differences between your method and the official method, because that just adds to the confusion. It would be more helpful to just focus on your method and explain it in a way that noobs can understand.
I do appreciate your feedback, but I think at a minimum that anyone trying to run a Lemmy instance in Docker should know how to install docker and docker compose and how to run basic commands like docker compose up -d. There are many tutorials out there for doing just that and I'm not trying to reinvent the wheel. Once you have gotten that part done my document kicks in and picks up where the official documentation is currently lacking (in my opinion).
I do explain a lot, but I did my best to explain it in terms that most anyone could understand.
I will take your feedback to heart and maybe try to write a step by step tutorial for people who are completely new to Docker as well.