Update reference-spec.md

This commit is contained in:
Robert Wallach
2018-03-22 12:00:48 -05:00
committed by GitHub
parent 9a3b527a4b
commit 74ce7506e7

View File

@@ -1,13 +1,13 @@
# Referencing Another API Specification
<!-- REFBUILDER GIF/VIDEO-->
![Referencing Another API Specification](https://github.com/stoplightio/docs/blob/develop/assets/gifs/modeling-ref-other-spec.gif?raw=true)
## What
Referencing another specification allows for cleaner and more organized code. Some use cases are as follows:
* Generate API documentaion in Hubs
* Deduplicate common structures like responses or shared parameters in Modeling
* De-duplicate common structures like responses or shared parameters in Modeling
* Test a connected API specification in Scenarios
* Setup a mock server for an API in Prism