forked from apidoc/apidoc
-
Notifications
You must be signed in to change notification settings - Fork 0
Home
Peter Rottmann edited this page Mar 4, 2014
·
9 revisions
Welcome to the apiDoc wiki!
Visit http://apidocjs.com for docs and examples.
ToDo: Functionality
- Extend
@apiExamplewith an optional type (e.g. JS, CURL, Ruby, ...) and add different views in the template - Add
@apiDocument {(before|after}:group} [Nav-Title] Description - Add ability for file inclusion in all Description fields, e.g.
@./dir/file.md - Remove: package.js apidoc entries (not needed if
@apiDocumentis implemented) - Fix: sorting "compare with prevoius" list is wrong.
- Simple call of API-Methods from generated documentation (but iam not 100% sure about that)
- Code Review
- Check if
@apiParamTitleshould be global function or local with versioning, at the moment it is global - Multiple Structure usage
- Simplify define and usage of structures, only one define and usage is necessary:
- @apiDefineStructure, @apiDefineErrorStructure, @apiDefineSuccessStructure -> @apiDefineStructure
- @apiStructure, @apiErrorStructure, @apiSuccessStructure -> @apiStructure
ToDo: Improve Template
- Better navigation for many navpoints
- Parameter enhancement:
- Markdown integration in multiline Descriptions
- Include or reference of big example files (clearer reduced source code)