Umbrella Project documentation missing for Elixir 1.19

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:

  1. Has the documentation for umbrella projects been intentionally moved to another section?

  2. Is there any change in the recommended approach or best practices for working with umbrella applications in recent Elixir versions?

  3. 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.

It was intentionally removed in https://github.com/elixir-lang/elixir/pull/14637

This is where Phoenix links to now Mix.Project — Mix v1.19.5 (related issue: Umbrella Documentation linked by `phx_new` does not exist anymore · Issue #6603 · phoenixframework/phoenix · GitHub)

2 Likes