3 ms·
They have very well defined documentation for all the stable parts of the API, their code is modern and quite readable. In addition to this Lennart is good at
by DavidNielsen 11y ago
They have very well defined documentation for all the stable parts of the API, their code is modern and quite readable.
In addition to this Lennart is good at publishing lengthy explanatory blogposts aimed at system administrators.
Finally they have done a truly admirable job building a community and explaining the why's and how's of their project. This is evident in the fact that there is now a systemd conference coming up.
If this fails the test, I suggest that it is a marvelous failure which every project should strive to emulate.
To suggest that systemd is poorly documented indicates an insufficient exposure to the sad reality of most Open Source projects where "our unmaintained, outdated, bug riddled code base is the documentation" is the best case answer to the question of documentation.
- viraptor 11y agoYour first sentence seems to contradict the docs... which still don't describe "all the stable parts".
- geofft 11y agoHaving done distro-maintenance work that needed to be compatible with both systemd and upstart, I've read the explanatory blog posts and found them wonderful, and I've also found the detailed API documentation lacking in spots. There are a lot of praiseworthy things about systemd and its approach to documentation. The blog posts are definitely one of them. That doesn't mean everything is praiseworthy, that there's no room for improvement, or that complaints about things not being documented are illegitimate or inappropriate.