Mojolicious::Plugin::OpenAPI does not mention x-mojo-to

[KES777]

x-mojo-to is mentioned on Tutorial, but should be described in main DOC too

[jhthorsen]

Why? And where?

[KES777]

Mentioned here.

And not described here

[jberger]

The SYNOPSIS section specifically mentions

See Mojolicious::Plugin::OpenAPI::Guides::Tutorial for a tutorial on how to write a "full" app with application class and controllers.

Of which x-mojo-to is certainly most relevant. Currently there is essentially no description of routing in the main module documentation (which is usage information, configuration and helpers), all of that is saved for the tutorial. I'm not sure what is being asked for.

[jhthorsen]

@KES777: You just repeated your original comment and did not respond to my questions at all. I'll try to elaborate:

• Why does it need to be documented in the main module?
• Where in the main module would you add it?

I can also add: Doing such a change will make it difficult to draw the line for what to add to the main module and what to keep in the tutorial.

[KES777]

Why?

There should be a dictionary/context of module capabilities. With short description what options is it. The tutorial will describe whole picture: how to use this option

Where?

Create section in the bottom: Schema extended options x-mojo-name -- sets up route name x-mojo-to -- sets up controller for a generated route

[jhthorsen]

I don't agree with you. I will take a PR if it makes sense and gets upvotes.