instaunit
mm-docs
instaunit | mm-docs | |
---|---|---|
2 | 2 | |
22 | 16 | |
- | - | |
3.7 | 5.6 | |
2 months ago | 7 months ago | |
Go | PowerShell | |
- | GNU General Public License v3.0 only |
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.
instaunit
-
Stripe Open Sources Markdoc
Shameless plug: for REST APIs, I've written a tool called Instaunit which combines HTTP API integration tests with documentation generation, since these two things must always be maintained in lockstep.
It's got a ways to go before it generates output that looks as good as Stripe's documentation, but it makes it dead simple to create API documentation that's guaranteed to be in sync with your service, because it was generated by your tests when they ran.
https://github.com/instaunit/instaunit
-
Is there a recommended Test framework for Rest API?
Check out https://github.com/instaunit/instaunit. It lets you define the calls to be made and expected responses and will compare them semantically so you can match on expected fields without worrying about things like dates and IDs that you can't predict easily. It can also be used to generate documentation for your APIs which is awesome because your docs are then built from your tests so you know they are current and accurate.
mm-docs
-
Stripe Open Sources Markdoc
I am glad to know there are those that put so much thought into documentation. Documentations is just another service, and deserves all the same methodology: CI/CD, tests, components, reuse etc.
As far as I can see, you can get similar workflow with combination of existing tools. I created this docker image that combines them for very easy consumption and created thousands of pages of technical, functional and user documentation with it:
https://github.com/majkinetor/mm-docs
- Show HN: Documentation system for any kind of project and documentation type
What are some alternatives?
markdoc - A literate programming package for Stata which develops dynamic documents, slides, and help files in various formats
remark - markdown processor powered by plugins part of the @unifiedjs collective
wstest - go websocket client for unit testing of a websocket handler
ConvertOneNote2MarkDown - Ready to make the step to Markdown and saying farewell to your OneNote, EverNote or whatever proprietary note taking tool you are using? Nothing beats clear text, right? Read on!
awesome-go-education - A curated list of awesome articles and resources for learning and practicing Go and its related technologies.
mm-docs-template - Template to use with mm-docs
docs - Source code for the Streamlit Python library documentation
cryptogalaxy - Get any cryptocurrencies ticker and trade data in real time from multiple exchanges and then save it in multiple storage systems.
burp - Somehow idiomatic Go service
docs - Documentation site for Markdoc