Allow resources or methods to be tagged with multiple swagger tags

[enrique-guillen]

The swagger-editor allows clicking on tags and getting all endpoints tagged with that tag. It seems like Apipie only supports one customizable tag, which I'm guessing is the name of the class or the name in the resource_description.

The DSL could work like this:

  resource_description do
    name 'Foo | Bar'
    tags 'Foo', 'Bar', 'Baz'
    short 'A bar in the foo namespace that is related to Bazes'
  end

And/or:

  api :POST, 'foo/bars'
  param :relationships, desc: 'A qux object related to the bar can be created here.'
  resource_tags 'Foo', 'Bar', 'Baz', 'Qux'
  def index; ...; end

[iNecas]

The proposal sounds reasonable. I will be happy to review the changes once the PR is opened.

[enrique-guillen]

PR no longer a WIP.

[iNecas]

Closed by #634, thanks @enrique-guillen