I don’t know if I got your question right.. Do you mean your routes? Do you want a way to organize all your routes in a central manner so people can easily see all the routes and have easy access to its documentation without needing to know where to controller’s files are located?

If so, what I do is first create a pages/API.md file in the root of the project, with something like this:

# APIs

## context 1

  > [/api/v1/context_1/my_api_call](`CoreWeb.V1.Context1Controller.my_api_call/2`)
  > [/api/v1/context_1/my_other_api_call](`CoreWeb.V1.Context1Controller.my_other_api_call/2`)

Then change mix.exs with:

def project do
  ...
  docs: docs()
end

defp docs do
  [
    main: "api",
    extras: ["pages/API.md"]
  ]
end

And then, finally, at the Context1Controller file, I simply use @doc to document the functions:

  @doc """
  blablabla
  """
  def my_api_call(conn, _), do: ...

  @doc """
  blablabla
  """
  def my_other_api_call(conn, _), do: ...

This will generate a Page in Exdocs.