search

petrochenko-pavel-a / raml-js-parser2-issues

0 stars 0 forks source link

Change `masterRef` to `extends` in RAML overlays and extensions #47

Closed VasiliyLysokobylko closed 8 years ago

VasiliyLysokobylko commented 8 years ago

RAML overlay and extension fragments must reference the RAML file they build upon. They currently do so through the property named masterRef. This name is inconsistent with most RAML property names, which strive to be either common English words such as title or trait or common technical terms such as baseUri or mediaType.

Instead of masterRef, I propose extends, as both overlays and extensions extend the original specification: overlays do so without changing the functional specification while extensions may change the functional specification.

VasiliyLysokobylko commented 8 years ago

https://github.com/raml-org/raml-spec/issues/228

petrochenko-pavel-a commented 8 years ago

This is handled by definition system cleanup