Shared parameters get picked up as a method

[acossta]

When you have shared parameters between methods ( as shown below), parameters taken as a method and not shown in the individual method pages

/Users/{userId}:
    parameters:
      - in: path
        name: userId
        required: true
        schema:
            type: String
        description: "The User's ID."
    get:
      summary: 'Returns details about a particular User'

[carlosrivera]

That's true, it should be easily fixable by parsing the path then look for parameters set with the option in: path, let me find some time this week to fix it. :)

Btw, somehow related: while the spec is already dereferenced and can be navigated, we haven't implemented full support for the entire schema, but fixing this kind of scenarios can get us closer to a more stable/generalized version.

[acossta]

The shared parameters can be either in: path or in: query. It is more about their position in the spec. If parameters are placed above the methods it means that all the methods of that route take those params. The idea is for the params to be populated on each of the method md files.