Sourcemap description and serialization #11
Conversation
|
|
||
| --- | ||
|
|
||
| ## Quick Links | ||
|
|
||
| + [AST Description](#ast-description) | ||
| + [Sourcemap Description](#sourcemap-description) |
There was a problem hiding this comment.
please use the term "source map" instead of "sourcemap" when discussing the topics
|
In a nutshell:
|
|
Also where is the explanation of payload source maps with the respect of references / symbol names? |
|
No need to bump this. Also I do not think that this is for @fosrias to review (albeit he is of course welcome to do so if he wants). |
| @@ -93,6 +96,7 @@ An [API Blueprint payload](https://github.com/apiaryio/api-blueprint/blob/master | |||
| + **request** payload: name of the request, if any | |||
| + **response** payload: HTTP status code | |||
|
|
|||
| + `reference` ([Reference](#reference-object)) - Present if and only if the payload references a [Resource Model](https://github.com/apiaryio/api-blueprint/blob/master/API%20Blueprint%20Specification.md#ResourceModelSection) | |||
There was a problem hiding this comment.
This is good but I would still add some extra clarification here so that everybody understands that when a reference is present the payload object was take by resolving a reference of a resource model. Same applies to payload source map
|
Note since we are changing the AST here you need to bump the version of AST serializations formats (do not forget to update parse results format as well). |
Sourcemap description and serialization
No description provided.