News for hackers. Stuff that matters.
Re:Systemd v227 by mateuszf on Thursday October 08, 2015 @05:01PM (#10356204)
Even if it's undocumented (as far as I know it is well documented), at least this code is in one place.
Re:Systemd v227 by simoncion on Thursday October 08, 2015 @05:33PM (#10356453)
A few people have attempted to use the systemd documentation to create a reimplementation. Bearing in mind that the task is complex and largely thankless, all the folks making attempts that I've heard about have reported that the available documentation does not provide enough information to complete such a task.

Note: I KNOW that documentation is seriously hard. But, one of the rebuttals of the "Systemd is complex and monolithic" assertion is "Systemd is fully documented, so you can replace any part of it with one that you've authored.". You can't honestly make that rebuttal if the state of your documentation doesn't support your claim.

Re:Systemd v227 by mateuszf on Friday October 09, 2015 @02:03AM (#10358409)
That's because if the code is over some quality level (which can be measured with bugs count) then the source itself is implementation documentation. And systemd contains the more classic documentation of its behaviour for its end users.
Re:Systemd v227 by simoncion on Friday October 09, 2015 @02:28AM (#10358477)
> ...if the code is over some quality level (which can be measured with bugs count) then the source itself is implementation documentation.

Oh, you summer child.

In any complex software project, there's always a difference between the contract described by the system's specification and the contract described by the software as implemented.

The big difference between the explicit contract of the documentation and implicit contract of the code is that -in areas on which the documentation is silent- the contract described by the code is subject to change at any time, without warning. Raymond Chen [0] has spilled much ink over customers who have gotten badly burned by changes in the implicit contract some time after they made use of something that the code permitted, but the documentation did not describe as possible and/or supported.

[0] Microsoft most notable backwards-compatibility guru

Re:Systemd v227 by mateuszf on Friday October 09, 2015 @02:42AM (#10358514)
> In any complex software project, there's always a difference between the contract described by the system's specification and the contract described by the software as implemented.

That's exactly the reason why source itself is better than implementation documentation - because it is always "current".

Re:Systemd v227 by simoncion on Friday October 09, 2015 @03:23AM (#10358606)
You managed to miss the larger point. Perhaps these resources will be helpful.

http://thecodelesscode.com/case/16

http://thecodelesscode.com/case/69

Re:Systemd v227 by mateuszf on Friday October 09, 2015 @03:48AM (#10358668)
In the second story: The scribe showed that source code may be too detailed, but at the same time he showed that past view of the system will not accurate now if not updated constantly. Which is the point I'm making.
Re:Systemd v227 by mateuszf on Friday October 09, 2015 @03:56AM (#10358696)
Regarding allowed changes in implementation:

If user behaviour doesn't change - why changes in implementation are wrong? Reimplementations can use the source code at one place in time and use that as a reference.