Hacker News Reader

> we see that nearly all of our clients that are using Nix are, at best, annoyed by the accidental complexity that comes with it

That is because it is an exemplary in accidental complexity at least from a user point of view. I cannot in good faith introduce it to an organization as it is way too complex to use / configure, only thing with worse documentation I've seen was PHP (this in itself a big red flag).

View on HN

What are you talking about? Of all the problems PHP has (and there are many), the documentation is not one of them. It (php.net) is complete, easy to browse or use as a reference, mostly accurate and even includes comments where community with good intentions (but admittedly, usually less good knowledge) helps clarify any corner cases. Which you can ignore of course.

The language itself sucks (and this bleeds into the code), but the idea of it and the documentation are great imho.

Do you still need to scroll down to the comments to find whether the function you're looking at is safe to use or a ticking time bomb? Also, in my opinion, the fact that there's a comment section, and they're considered "helpful" to boot, is a sign that the documentation is lacking and people are trying to fill its holes.

Reply on news.ycombinator.com