| iommi | notebook | |
|---|---|---|
| 3 | 2 | |
| 628 | 4 | |
| 0.8% | - | |
| 9.1 | 3.0 | |
| 14 days ago | about 1 year ago | |
| Python | TypeScript | |
| BSD 3-clause "New" or "Revised" License | MIT 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?
notebook
-
Evidence – Business Intelligence as Code
How about something like [`input`](magic-link)? I came up with this for https://codeberg.org/macchiato ( though it's not yet implemented in the new project, just in the predecessor, https://github.com/ResourcesCo/notebook ). The backquotes differentiate from non-magic links. (I tried badges, but they aligned weirdly.)
You could use [`data.mrr`](https://evidence.dev/md/value) or any other internal DSL you can come up with.
Another thing you could do is just decide against MDX the format and keep the style and transform inline codeblocks that match.
That you said Markdown to me says you aren't on board with using an incompatible syntax.
-
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.
jupysql - Better SQL in Jupyter. 📊
pytest-doctestplus - Pytest plugin providing advanced doctest features
examples - TensorFlow examples
hanakotoba - Exploring 花言葉 in Japanese and other literary corpora
httpyac - Command Line Interface for *.http and *.rest files. Connect with http, gRPC, WebSocket and MQTT
djot - A light markup language
KeenWrite - Free, open-source, cross-platform desktop Markdown text editor with live preview, string interpolation, and math.
datapane - Build and share data reports in 100% Python