feat: better openapi docs #1300
Conversation
github-actions
bot
added
the
t-tooling
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
There was a problem hiding this comment.
Pull request is neither linked to an issue or epic nor labeled as adhoc!
There was a problem hiding this comment.
Pull request is neither linked to an issue or epic nor labeled as adhoc!
There was a problem hiding this comment.
Pull request is neither linked to an issue or epic nor labeled as adhoc!
There was a problem hiding this comment.
Pull request is neither linked to an issue or epic nor labeled as adhoc!
|
I took a look and I think the easiest way will be to just exclude /source/api from mdlint, vale & typos |
|
That's exactly what I am trying to do, it works for typos, still battling with the other two. |
B4nan
force-pushed
the
new-api-docs
branch
2 times, most recently
from
4b0b2c7 to
6c695c7
Compare
This PR overhauls our OpenAPI setup completely:
apify-apifolder)npm startwill generate the specs as well as produce the MDX files out of themnpm run api:rebuildwill rebuild the yaml spec file and recreate the MDX filesfastermode (rust based tooling)Things to discuss:
index page now only redirects, maybe we should move the content from the introduction section (so outside of OpenAPI specs)folder structure