Glitterkoe

joined 1 year ago
[–] Glitterkoe 1 points 1 week ago

It shouldn't be too hard to have a backup domain point to the same resources. Could even be setup as a fallback mirror by default.

[–] Glitterkoe 3 points 1 year ago* (last edited 1 year ago)

You can't pick a Scottish accent for your character in Baldurs Gate 3 and now my Dwarf just sounds British. It sounds, well... off

[–] Glitterkoe 10 points 1 year ago

The "ICH POLICE" with the door opened is a rather Schwarzenegger way to state your occupation, too 👌

[–] Glitterkoe 3 points 1 year ago

At least they tired

[–] Glitterkoe 1 points 1 year ago* (last edited 1 year ago)

By now, the pymdownx.snippets extension that retrieves sections from plain pytest Python files seems to be my way to go. Tests run code as always, which is also formatted as always, specifically marked sections end up in docs. Win, win, win by grace of the scissors operator.

[–] Glitterkoe 124 points 1 year ago (33 children)

Tried it for a week or two, but since I reinstalled Firefox I really don't understand why I was judging/hating so much in the past years. Yes, Chrome/ium used to be waaaay faster, but Mozilla just has their shit together most of the time. The Debian of browsers so to speak.

 

Hey there!

I'm looking to move my documentation over to MkDocs (+Material Theme), but I'm struggling to integrate testable code examples. Does anyone have a workflow for this?

Main requirements:

  • Testable. Want to make sure my examples work as intended.
  • Continuable code fences (i.e. some regular Markdown in between chunks of code)

Nice-to-have:

  • Formatting
  • Output checking (otherwise, regular asserts will do)

I would have thought Python to have near first-class support for this, but there doesn't seem to be a clear winner as far as plugins go.

Any ideas?

[–] Glitterkoe 18 points 1 year ago (1 children)

Keep in mind that they are still on the 0.x.x versions. That usually signals a not yet fully matured platform. I'm sure there will be some bumpy times ahead while users keep pouring in.