News for hackers. Stuff that matters.
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.