Add support for paths with alternate keys

[millicentachieng]

Fixes #120

This PR:

• Adds new paths for entities that have alternate keys
• Renames the summary and OperationId of operations to include key name
• Add a setting to enable the generation of paths with alternate keys

[baywet]

I also believe we should introduce a setting for that new behavior

[millicentachieng]

I also believe we should introduce a setting for that new behavior

I had a discussion with @darrelmiller regarding this, and we thought that if there are alternate keys defined in the metadata then we ought to generate paths that utilize them as well.

Do you think the presence of these paths is going to affect any downstream tools? CC @peombwa

[baywet]

It might increase significantly the size of the SDKs, especially for sets that are fairly "close to the root" of the API paths tree since the logic might go ahead and expand all the paths we already had under the main key.
Additionally, the "custom" has been to introduce settings as a way for consumers to control the behaviour of the conversion every time we've introduced changes that add additional paths to the resulting description. This way, should somebody complain about the new paths and not want them, they have a workaround.

[millicentachieng]

@baywet We decided not to expand the paths using alternate keys. I will be adding the setting.

[baywet]

Thanks, that's what I suspected from the code but I wasn't sure whether it was a final decision or a stopgap.

[baywet]

thanks for making the changes!

[peombwa]

I also believe we should introduce a setting for that new behavior

I had a discussion with @darrelmiller regarding this, and we thought that if there are alternate keys defined in the metadata then we ought to generate paths that utilize them as well.

Do you think the presence of these paths is going to affect any downstream tools? CC @peombwa

As @baywet said above, we may see a significant growth in paths. However, having the setting to control how paths with alternate keys are generated is enough to warrant any concerns with downstream tools.