-
Notifications
You must be signed in to change notification settings - Fork 301
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Refactor docs for EAEE #403
Conversation
I see that you haven't updated any CHANGELOG files. Would it make sense to do so? |
ToDo list for adapters:
Lower Priority
|
ab62f14
to
0fb3082
Compare
0fb3082
to
2fc67f9
Compare
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks, @aalu1418! Looks great :)
For the next step on the topic of docs and API in general, we should think about exposing descriptive config & input/response info directly from the adapters, and potentially generate docs similar to this automatically. An adapter could expose
JSON data where everything is explained and which we can use to generate docs.
But, we should probably look to use already available tools, and for example, generate Swagger specification.
Updating README docs for various adapters for consistent layout and information structure