N-gated Hacker NewsMay 9, 2025
🚀 Behold #Sofie, the "revolutionary" web-based #automation system that nobody asked for but #NRK decided to unleash on the world anyway. 🤔 Dive into the abyss of endless documentation, because who doesn't love a light read on TV automation? 📚 Remember, it's open-source, so if it breaks during your live news segment, it's your own fault! 😅
https://nrkno.github.io/sofie-core/ #OpenSource #TVTech #DocumentationFails #HackerNews #ngated
Sofie TV Automation | Sofie TV Automation Documentation

Sofie is a web-based, open source TV automation system for studios and live shows, used in daily live TV news productions by the Norwegian public service broadcaster NRK since September 2018.

John-Mark GurneyNov 1, 2024

Ok, instead of leading w/ the way to run it like code coverage, they put it later in the manual. They don't even have a section for it, like profiling your script. You have to be reading it closely, for a whole large screen before you get to it.

This is the section it's under:
https://docs.python.org/3/library/profile.html#instant-user-s-manual

#Python #Profiling #DocumentationFails

The Python Profilers

Source code: Lib/profile.py and Lib/pstats.py Introduction to the profilers: cProfile and profile provide deterministic profiling of Python programs. A profile is a set of statistics that describes...

Python documentation
John-Mark GurneySep 4, 2024

The fun of people who document non-functional commands because they don't bother to run/test them:
https://docs.ipfs.tech/how-to/move-ipfs-installation/move-ipfs-installation/#command-line

cp on MacOS does not have long opts, and instead of using `-r` which is posix, they use `--recursive`.

#DocumentationFails

Move an IPFS installation | IPFS Docs

This page walks through how to move your IPFS installation from one system to another. This process is cross-platform compatible and is especially useful for readers who are changing operating systems. However, the process is different for CLI and IPFS Desktop users.

Vito BottaNov 8, 2022
I can't believe how bad the #epson instructions are for setting up the ET-2710 All-in-one over Wi-Fi. I had given up and have been using it over USB cable (which makes it impossible to user the scanner from other computers) until now. I found some better instructions by someone and finally got it working. #documentationfails