Open API Feature removes leading slashes from paths entries

[scottpopplewell]

Summary

Open API files typically have leading /s for paths keys. Do you have any more context on this commit which intentionally removes leading slashes from paths entries?

Current Behavior

Apexdocs removes the leading / from any path defined in @RestResource(urlMapping=.... Typically paths entries have a leading slash so that when appending with a servers entry, the resulting URL is a valid URL.

Expected Behavior

Apexdocs leaves the leading /.

Further Reading

Checkout this base Spectral rule which validates that paths have a leading / and documentation from SmartBear aka Swagger which describes creating paths with leading slashes.

[cesarParra]

Good call @scottpopplewell . When this was developed it was done targeting an internal tool which from what I recall was having issues with the leading slash. But this should definitely respect the specification. I'll look into this

[scottpopplewell]

You da boss. Thanks @cesarParra . Ravi and I both work at IH together and love the work you're doing here.

[cesarParra]

The latest version (3.3.2) contains the changes.