diff --git a/rebar.config b/rebar.config
index c2f00fbb..2b67d900 100644
--- a/rebar.config
+++ b/rebar.config
@@ -36,6 +36,8 @@
             warnings_as_errors
            ]}.
 
+{edoc_opts, [preprocess]}.
+
 %% Use OTP 18+ when dialyzing rebar3
 {dialyzer, [
     {warnings, [unknown]},
diff --git a/src/r3.erl b/src/r3.erl
index a79cc3a1..60a585dc 100644
--- a/src/r3.erl
+++ b/src/r3.erl
@@ -13,11 +13,11 @@ do(Command) -> rebar_agent:do(Command).
 -spec do(atom(), atom()) -> ok | {error, term()}.
 do(Namespace, Command) -> rebar_agent:do(Namespace, Command).
 
-%% @async_doc alias for `rebar_agent:async_do/1'
+%% @doc alias for `rebar_agent:async_do/1'
 -spec async_do(atom()) -> ok | {error, term()}.
 async_do(Command) -> rebar_agent:async_do(Command).
 
-%% @async_doc alias for `rebar_agent:async_do/2'
+%% @doc alias for `rebar_agent:async_do/2'
 -spec async_do(atom(), atom()) -> ok | {error, term()}.
 async_do(Namespace, Command) -> rebar_agent:async_do(Namespace, Command).