Ignore path parameter name changes?

[reuvenharrison]

How should diff handle path parameter renaming?

For example:
/books/{id} -> /books/{bookId}

Our options are:

1. Display such changes at the path level:

endpoints:
    added:
        - method: GET
          path: /books/{bookId}
    deleted:
        - method: GET
          path: /books/{id}

2. Display such changes at the param level:

paths:
    modified:
        /books/{id}:
            parameters:
                modified:
                    path:
                        id:
                            name:
                                from: id
                                to: bookId

4. Ignore such changes
5. Make it configurable

See #202

[EpicWink]

I prefer it to be ignored, as there are no changes to the API.

I would also be okay with displaying the changes at the parameter level, although I don't think OASDiff should fail due to this when -fail-on-warns is passed.

PS: option list item 3 is missing