I used to think that I had matured. That I should stop letting my emotions get the better of me. Turns out there's only so much one can bottle up before it snaps.

Allow me to introduce you folks to this wonderful piece of software: PaddleOCR (https://github.com/PaddlePaddle/...). At this time I'll gladly take any free OCR library that isn't Tesseract. I saw the thing, thought: "Heh. 3 lines quick start. Cool.", and the accuracy is decent. I thought it was a treasure trove that I could shill to other people. That was before I found out how shit of a package it is.

First test, I found out that logging is enabled by default. Sure, logging is good. But I was already rocking my own logger, and I wanted it to shut the fuck up about its log because it was noise to the stuffs I actually wanted to log. Could not intercept its logging events, and somehow just importing it set the global logging level from INFO to DEBUG. Maybe it's Python's quirk, who knows. Check the source code, ah, the constructors gaves `show_log` arg to control logging. The fuck? Why? Why not let the user opt into your logs? Why is the logging on by default?

But sure, it's just logging. Surely, no big deal. SURELY, it's got decent documentation that is easily searchable. Oh, oh sweet summer child, there ain't. Docs are just some loosely bundled together Markdowns chucked into /doc. Hey, docs at least. Surely, surely there's something somewhere about all the args to the OCRer constructor somewhere. NOPE! Turns out, all the args, you gotta reference its `--help` switch on the command line. And like all "good" software from academia, unless you're part of academia, it's obtuse as fuck. Fine, fuck it, back to /doc, and it took me 10 minutes of rummaging to find the correct Markdown file that describes the params. And good-fucking-luck to you trying to translate all them command line args into Python constructor params.

"But PTH, you're overreacting!". No, fuck you, I'm not. Guess whose code broke today because of a 4th number version bump. Yes, you are reading correctly: My code broke, because of a 4th number version bump, from 2.6.0.1, to 2.6.0.2, introducing a breaking change. Why? Because apparently, upstream decided to nest the OCR result in another layer. Fuck knows why. They did change the doc. Guess what they didn't do. PROVIDING, A DAMN, RELEASE NOTE. Checked their repo, checked their tags, nothing marking any releases from the 3rd number. All releases goes straight to PyPI, quietly, silently, like a moron. And bless you if you tell me "Well you should have reviewed the docs". If you do that for your project, for all of your dependencies, my condolences.

Could I just fix it? Yes. Without ranting? Yes. But for fuck sake if you're writing software for a wide audience you're kinda expected to be even more sane in your software's structure and release conventions. Not this. And note: The people writing this, aren't random people without coding expertise. But man they feel like they are.

So I thought there might be some people here
that care about formatting and would enjoy this:

https://github.com/MarkedDown

*Or people that just want to improve*
*their README / documetation I guess~*

Follow-up on https://devrant.com/rants/5001553/...

How the fuck are Jupyter notebooks so popular in research? Like some dude had an idea to take perfectly good markdown and python code, add a whole lot of transitional properties to make version control impossible, encode it as JSON on the assumption that a human could somehow look at it and make sense of countless escaped characters and base64 encoded data, create dedicated software people need to install in order to read what used to be simple plain text, and think "This. This is what 99% of data researchers will use from now on." And somehow, overwhelming majority of researchers agreed that this extremely inefficient data format is the best there is and they should develop all their tools around it.

Anybody need some help with documentation?
( GitHub Only )

Check these links for my style:
https://github.com/ElectronicsArchi...
https://github.com/MarkedDown

Can we have a moment of silence for the jekyll themes that are supported on GitHub?

https://pages.github.com/themes/

Jesus Christ I'm in the graveyard here

Started documenting on how to use ＬａＴｅＸ ( MathJax ) in Ｍａｒｋｄｏｗｎ.

https://github.com/MarkedDown/Math

Let me know if you have a topic that you would like to be documented sooner than others~

Image shows an example usage
from a project I'm working on:

https://github.com/OpenlyEducated/...

Finally got around to turning the news-section generator markdown / deno thingy into a GitHub Action!

https://github.com/MarkedDown/News

Haven't finished writing the documentation though.

Found a 'new' little way of customizing /
stylizing / formatting GitHub markdown.

Because of that I just had to document
it in a new section of my MarkedDown
project.

https://github.com/MarkedDown/...

Hope someone finds it useful~

Typora was the best (closed-source) free markdown editor. As soon as it hit the first stable release, it became non-free. Luckily, you can still download the last beta from https://typora.io/releases/all (click Dev/Beta releases -> scroll down to 'More Beta')