Add docs to Either, change arg order in either/3

In Elixir the subject (most important argument) always comes first so that |>
pipelining may work.
Merge branch 'pm-either-docs' into develop