feat: comments that can be skipped in a file at once

[Javakky-pxv]

Created based on discussion of #469

You can completely ignore the file by placing ### SkipFileForDocs ### at the beginning of the file like this.

### SkipFileForDocs ###

GET      /api/hidden/a                 controllers.hiddenEndPointA()
GET      /api/hidden/b                 controllers.hiddenEndPointB()
GET      /api/hidden/c                 controllers.hiddenEndPointC()

Looking at SBTSubProjects, the routes file splitting seemed to be a feature for subprojects, but it actually works, so it may be useful for semantic file splitting.

/conf/routes:

GET /index                  controllers.Application.index()

->  /admin admin.Routes

GET     /assets/*file       controllers.Assets.at(path="/public", file)

/conf/admin.routes

GET /index                  controllers.admin.Application.index()

GET /assets/*file           controllers.admin.Assets.at(path="/public/lib/myadmin", file)

[Javakky-pxv]

If the keyword is at the beginning of the file, it is not read in the first place.

[Javakky-pxv]

@kailuowang
Please, review 🙏

[Javakky-pxv]

@kailuowang
I understand you are very busy, but I deeply desire a review of this PR and the release of a version that includes everything.
If you are unable to work on it for the time being, it would be greatly appreciated if you could let us know when you expect to be able to start work on it.

[Javakky-pxv]

@kailuowang
Thanks

[kailuowang]

Sorry I was travelling on my vacation last 3 weeks. Just got back home. This looks great! Thanks so much!

[Javakky-pxv]

@kailuowang
By the way, how do I know that a new version has been released?

[kailuowang]

Sorry i have no idea. but I know this bot seems have a way to get notified with new releases. https://github.com/scala-steward-org/scala-steward

…

On Mon, Aug 8, 2022 at 8:51 AM Kazuma Iemura ***@***.***> wrote: @kailuowang <https://github.com/kailuowang> By the way, how do I know that a new version has been released? — Reply to this email directly, view it on GitHub <#491 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AAAUKOJQBCJANXTZAVTTWRTVYD7GTANCNFSM544ISV5A> . You are receiving this because you were mentioned.Message ID: ***@***.***>

-- Kai

[Javakky-pxv]

@kailuowang
This method is not yet available for my project because of the pending implementation of play-swagger, but I would like to use it in the future.