iommi
macchiato-early-brew
iommi | macchiato-early-brew | |
---|---|---|
3 | 1 | |
628 | 0 | |
0.8% | - | |
9.1 | 10.0 | |
15 days ago | almost 2 years ago | |
Python | ||
BSD 3-clause "New" or "Revised" License | - |
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.
iommi
-
Building a full Django project, starting with a single file
It's not really tied to manage.py no. And in any case that's a trivial 3 lines of code (plus imports, blank lines: https://github.com/iommirocks/iommi/blob/master/examples/man...).
I think you're overdramatizing 3 lines of code...
-
Beyond OpenAPI
It's all about the tooling. I wrote my own for iommi where the html output of some code gets saved in a defined place, and then the finished documentation page embeds that html in an iframe. It's not only WAY WAY easier to maintain than a bunch of screenshots, but I found a ton of issues with the documentation after I made it so it runs all the examples and I can look at the output.
example: https://docs.iommi.rocks/en/latest/cookbook_forms.html
corresponding documentation/tests: https://github.com/iommirocks/iommi/blob/master/docs/test_do...
my evil hack to get this working: https://github.com/iommirocks/iommi/blob/master/make_doc_rst... and https://github.com/iommirocks/iommi/blob/master/iommi/docs.p...
-
Markdown, Asciidoc, or reStructuredText – a tale of docs-as-code
is generated from this pytest source: https://github.com/TriOptima/iommi/blob/master/docs/test_doc...
Is that how rust documentation works?
macchiato-early-brew
-
Markdown, Asciidoc, or reStructuredText – a tale of docs-as-code
Markdown can literally be code. RMarkdown is this. Before I learned of RMarkdown I had written something to extract code blocks with filenames that are visible in the rendered page (since hiding it at the end of the first triple backquote codefence isn't great for visibility). I'm currently working on a notebook tool. https://github.com/ResourcesCo/macchiato/blob/main/scripts/m... https://github.com/ResourcesCo/notebook
What are some alternatives?
diataxis-documentation-framework - A systematic approach to creating better documentation.
eleventy-plugin-asciidoc - Eleventy plugin to add support for AsciiDoc.
katt - KATT (Klarna API Testing Tool) is an HTTP-based API testing tool for Erlang.
pytest-doctestplus - Pytest plugin providing advanced doctest features
notebook
httpyac - Command Line Interface for *.http and *.rest files. Connect with http, gRPC, WebSocket and MQTT
KeenWrite - Free, open-source, cross-platform desktop Markdown text editor with live preview, string interpolation, and math.
djot - A light markup language
book - The Rust Programming Language
restclient.el - HTTP REST client tool for emacs
vscode-restclient - REST Client Extension for Visual Studio Code