Hello everyone,
While reading the documentation for Mix and OTP in Elixir 1.19, I noticed something that seems different compared to the documentation in Elixir 1.18.
In Elixir 1.18, the Mix and OTP section contains a page about umbrella projects. However, when looking at the documentation in the main branch that corresponds to the upcoming Elixir 1.19 documentation, that umbrella project page does not appear to be present in the same section.
For reference:
Elixir 1.18:
https://github.com/elixir-lang/elixir/tree/v1.18/lib/elixir/pages/mix-and-otp
Main branch (future 1.19 docs):
https://github.com/elixir-lang/elixir/tree/main/lib/elixir/pages/mix-and-otp
From what I can see, the umbrella-related documentation seems to be missing or possibly moved elsewhere.
My questions are:
-
Has the documentation for umbrella projects been intentionally moved to another section?
-
Is there any change in the recommended approach or best practices for working with umbrella applications in recent Elixir versions?
-
If it was moved, where is the new canonical documentation location?
I’m currently working on restructuring an existing Phoenix application into an umbrella project, so I wanted to make sure I’m following the current recommended approach.
Thank you in advance for the clarification.






















