@borup Judging by rudimentary or entirely missing usage examples in many projects, many people disagree in practice, even if they agree in theory.

Possibly unorthodox opinion: it's important to have good sample programs for a library/framework because at least some people will look for samples for cargo-cult programming—let those be good samples. ;)

@zkat In VyOS, we are still paying off the technical debt (implementation and, most importantly, architectural) it accumulated in its previous life as Vyatta, when it had millions in VC funding. As a community-driven project backed by a self-funded company, we can finally work to get it right.