Yes, I skimmed through that and was surprised to see it be compared to Django. It's different.
Django is for building CRUD apps quickly. That's it. It's not for the long haul of super complicated apps, which many projects don't ever reach before they fail/get abandoned.
99% of line-of-business apps are CRUD. There's nothing special about "super complicated apps" that isn't brought in by the Python ecosystem. Where exactly do you think Django fails in that regard?
I love Django. I just think Python without types makes things hard at scale.
MyPy and friends have made this much, much better. In the long term it's probably not ideal for very large systems in many applications.
I've been using it with an IDE and it's quite nice. I'll probably be using Django for a lot of future projects.
I agree that there are better options for long-term maintenance of large projects, but let's not act like Youtube or Instagram don't exist - both of which used Django to some (high at the beginning) degree.
https://hexdocs.pm/phoenix/ecto.html#using-the-schema-and-mi...
As for the comparison to Django, I don't really expect any web framework to have docs at that level. They are simply huge and have been around for quite a while.