make ex_doc and inch_ex dev only

[tsloughter]

Needed to do this so doc generation worked, I guess because docs env doesn't exist.

[tsloughter]

I don't know what inch_report is..

[hauleth]

@tsloughter you can do env MIX_ENV=docs mix docs. In Mix you do not need to define environments, all are already there.

[tsloughter]

And I have to publish the package with MIX_ENV=docs?

[hauleth]

This is how I have been doing that, alternatively you can add :dev as well to the :only list.

About Inch, this is CI for the documentation: https://inch-ci.org/github/opencensus-beam/opencensus_elixir

[garthk]

So glad I read this; turned out I'd broken mix docs also by copying the pattern. Ended up with:

  def project do
    [
      preferred_cli_env: [
        # ...
        docs: :docs,
        inch: :docs,
        "inch.report": :docs,
        "inchci.add": :docs
      ],
     # ...
    ]
  end

… and

  defp deps() do
    [
      # ...
      {:ex_doc, ">= 0.0.0", only: [:dev, :docs], runtime: false},
      # ...
      {:inch_ex, "~> 2.0.0", only: :docs, runtime: false},
      # ...
    ]
  end

… so mix publish in particular can also generate docs.

[garthk]

@tsloughter want me to pick this work up if you're concentrating more on the Erlang side of things?

[tsloughter]

@garthk that'd be great, thanks.