Comments (1)
Hi @jwpegram in order to use "$ref you can use the way we define components. You don't need to specify the file you only need to put the right name.
For example
/**
* A song
* @typedef {object} Song
* @property {string} title.required - The title
* @property {string} artist - The artist
* @property {number} year - The year - double
*/
/**
* Author model
* @typedef {object} Author
* @property {string} name.required - Author name
* @property {integer} age - Author age - int64
*/
/**
* Album
* @typedef {object} Album
* @property {Song} firstSong
* @property {Author} author
*/
This package will do the "$ref" for you so you don't need to worry about that. In case you want to place the comments in different files. In the configuration, you can specify multiple files.
You can have a look at our Docs page 👍 We have more info, and examples of the possibilities this library offer 😄
from express-jsdoc-swagger.
Related Issues (20)
- How to use with Express Router
- Syntax for specifying JSON object fields and nested objects in one place HOT 3
- Format is missing in response HOT 1
- Security template for Cookie
- Add support for `@augments`/`@extends` tag HOT 2
- Allow specifying global security schema for all routes HOT 3
- Add support for OAS 3 callback documentation
- [BUG] Unable to render this definition HOT 1
- Authorization Header [BUG] HOT 3
- Theme? HOT 1
- import file contained typedef is not recognized HOT 2
- [BUG] Unable to render this definition (production) HOT 1
- Adding Typescript Schema types into the comments HOT 3
- Adding REQUEST Header for Apis HOT 2
- express-jsdoc-swagger sometimes fails generating code HOT 2
- [BUG] Cannot generate example using media type = application/problem+json
- [BUG] enum does not support integer type
- elastic beanstalk fails swagger with timeout
- Upgrade `glob` dependency to >= v10
- Support @ start symbol in property definition
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from express-jsdoc-swagger.