News for hackers. Stuff that matters.

A comment on YAML: Probably not so great after all. Parent comment

Re:YAML: Probably not so great after all by CriticalCathed on Monday August 19, 2019 @12:10AM (#20734826)
If it's that important and complex, have an accompanying README that lists line numbers and comments.
[ Parent | on HN ]
Re:YAML: Probably not so great after all by js8 on Monday August 19, 2019 @01:59AM (#20735245)
Good idea! And then put a comment into the configuration file that refers to where the documentation is.. ah, f__k!
[ Parent | on HN ]
Re:YAML: Probably not so great after all by meddlepal on Monday August 19, 2019 @12:29AM (#20734905)
Lesson to learn: Nobody reads the docs.
[ Parent | on HN ]
Re:YAML: Probably not so great after all by CriticalCathed on Monday August 19, 2019 @03:14AM (#20735593)
This is such a dumb aphorism. I read and create docs every single day.

If the comments are so critical that it is a problem, then an accompanying file with those comments would be used. Otherwise, it's just a bunch of crocodile tears.

[ Parent | on HN ]