Remove :nodoc: from singular method aliases, add Int#microsecond alias

[Sija]

Refs #6273

[j8r]

@Sija do you realize this aliases are only one character different?

[asterite]

@j8r It's about being able to write sleep 1.minute instead of sleep 1.minutes.

[Sija]

@j8r yes, I do, see @asterite's comment.

[j8r]

The ditto descriptions are bad.
The generated API docs sorts methods alphabetically.
Therefore we will have:

• #ago, which has a proper description
• #day, which have ditto as a description
• #days, which has a proper description.

I don't see better descriptions than "Like #days but without an s" , which is bad 😶
The same applies with the other methods.

[asterite]

@j8r ditto is processed at the semantic level. That the methods are sorted alphabetically doesn't mean the ditto will be applied like that.

[j8r]

Sorry @asterite this wasn't as clear as :nodoc:, which has colons. Adding them around :ditto: will make more obvious that its a special semantic.

[RX14]

Yeah I considered that, but it's such a minor change that it's really not worth breaking.

[j8r]

@RX14 :ditto: seems to be already supported here, and also nodoc (without colons) here.
If yes, ditto can already be changed to :ditto:.
I can send a PR about removing the non-colons version of ditto and nodoc.

[RX14]

:ditto: and nodoc are unused in my experience, ditto and :nodoc: are what people tend to use. I'm not sure thats worth changing.

[straight-shoota]

@RX14 @j8r please discuss this in a separate issue. Thanks 👍

[RX14]

Just needs review

[j8r]

We can use a single macros to add all this non s variants:

{% for time in %w(nanosecond microsecond millisecond second minute hour day week month year)  %}
 # Returns a `Time::Span` of `self` {{time.id}}s.
  def {{time.id}} : Time::Span
    {{time.id}}s
  end
{% end %}

[Sija]

Can this go forward?

[Sija]

2nd review, @bcardiff @asterite, anyone?