Make releases less noisy

[troessner]

Since we are explicitly putting version numbers in our documentation links our releases have become very noisy as you can see in #1391.
Ideally, there would be one cucumber feature that ensures that our links change as well with new versions and that would then cause a one line change per new version release.

[mvz]

Agreed. Perhaps we can add some interpolation in the expected strings in the feature files.

[eloyesp]

As documentation is bundled with the gem, links could point to the local filesystem, that way you don't need github nor version number and also don't need internet.

The documentation can also be provided inline (with a flag or may be a custom command).

app/controllers/users_controller.rb -- 33 warnings:
  [48, 50, 54, 56]:DuplicateMethodCall: UsersController#add_admin_role calls '@user.name' 4 times [ reek doc duplicate_method_call ]

$ reek doc duplicate_method_call
# Duplicate Method Call

Markdown here

[troessner]

That is a very good idea, thank you for that :)
We might come back to this in the future.