diff --git a/rebar.config.sample b/rebar.config.sample
index f4ce43fc..e9bf66d4 100644
--- a/rebar.config.sample
+++ b/rebar.config.sample
@@ -252,3 +252,16 @@
 %% * {module(), function()},
 %% * {module(), function(), arity()}
 {xref_ignores, []}.
+
+%% == alias ==
+
+%% When you want a certain combination of operations to be done
+%% as if you were using a rebar3 command. In the example below:
+%% > rebar3 check
+%%   (equivalent to rebar3 do xref, dialyzer)
+%% or
+%% > rebar3 test
+%%   (equivalent to rebar3 do eunit, ct --suite=rebar_alias_SUITE, cover)
+
+{alias, [{check, [xref, dialyzer]},
+         {test, [eunit, {ct, "--suite=rebar_alias_SUITE"}, cover]}]}.