Inch
Apipie
Our great sponsors
Inch | Apipie | |
---|---|---|
1 | 2 | |
519 | 2,446 | |
- | 0.2% | |
5.7 | 7.2 | |
3 months ago | 13 days ago | |
Ruby | Ruby | |
MIT License | Apache License 2.0 |
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.
Inch
-
Ask HN: How do you upskill your teams technical writing?
As a 20+-year full-stack veteran (and once-upon-a-time English major), I second this. Even the best writers in literature had editors.
To gamify documentation and review, add a static analyzer that measures documentation coverage to CI. Not sure what your stack is, but for Ruby one I've had success with was Inch: https://github.com/rrrene/inch.
Apipie
- Is there a way to easily autogenerate API documentation for a Ruby on Rails API?
-
OpenAPI/Swagger comment parser for ruby
This gem takes directives in your controllers and can output swagger.json. It takes some work but it is nice that it can provide examples by capturing test output and because of this it doesn't get out of date as easily. https://github.com/Apipie/apipie-rails
What are some alternatives?
YARD - YARD is a Ruby Documentation tool. The Y stands for "Yay!"
grape-swagger - Add OAPI/swagger v2.0 compliant documentation to your grape API
Apidoco - Ruby on Rails API documentation tool
rswag - Seamlessly adds a Swagger to Rails-based API's
Asciidoctor - :gem: A fast, open source text processor and publishing toolchain, written in Ruby, for converting AsciiDoc content to HTML 5, DocBook 5, and other formats.
rspec_api_documentation - Automatically generate API documentation from RSpec
Hanna - RDoc generator designed with simplicity, beauty and ease of browsing in mind
RDoc - RDoc produces HTML and online documentation for Ruby projects.
Doctor
Annotate - Annotate Rails classes with schema and routes info