You need to modify config. Server or platform type config.
What's your favorite or preferred way to get this done? YAML, XML, JSON, something else? All of the above? Some mix?
Does your answer change if the config is lengthy and/or nested?
Top comments(20)

- Email
- LocationOhio, United States of America
- WorkSite Reliability / DevOps Engineer at Netdata Incorporated
- Joined
YAML, for a couple of very specific reasons:
- It's reasonably concise. YAML doesn't waste huge amounts of space like XML usually does, it just uses exactly what's needed for structure and nothing more.
- It allows comments. This is honestly one of my biggest complaints about JSON. On any reasonable system, your configuration should be properly documented, and that's harder to do without comments. Also, lack of support for comments makes it hard to temporarily disable a segment of the configuration.
- It's not picky about quotes. Another complaint about JSON specifically, and some other config formats generically. Ihate having to remember what type of quotation marks to use around values that need quoted, and for that matter whether or not values need quoted at all. YAML makes this dead simple.
- In most implementations, it allows both full and partial reuse of segments of the configuration. This is a huge benefit when dealing with situations where you have to use essentially the same configuration for a bunch of things with minimal modification. YAML is a bit unique in that it's the only widespread config formats that lets you reuse the contents of a mapping while selectively changing only some keys.

- LocationUSA
- WorkHolistic technologist at Various
- Joined
I'm using JSON these days just because most of my day to day coding is js/ts and the native integration of JSON with these projects is seamless and clear.
I also agree with everything Austin S. Hemmelgarn expressed so clearly above.
Mostly I don't choose XML anymore. It was my go-to until just a few years ago.
One format you didn't mention that is still around in a big way for shell scripts is simple Key=Value files. They are not going away soon enough. :)

- LocationThailand
- EducationYes
- Joined
I have to disagree about quotes (standard should always be double quotes, and if single quote only for chars), and there is problem aboutYes
,No
,true
,false
,date-time
.
It is just some JSON over-done.
Otherwise, you are right about circular reference.

- Email
- LocationOhio, United States of America
- WorkSite Reliability / DevOps Engineer at Netdata Incorporated
- Joined
I'll agree on the point about handling of booleans, it gets a bit tricky at times in YAML, especially since some tools that use YAML accept other things for booleans (for example, lots of stuff accpetson
andoff
as booleans in it's configuration when using YAML).
As far as quotes though, I would argue that it's actually better even for those who are pedantic about quoting that YAML doesn't care. Yes, you might run into existing YAM that quotes things differently than you expect, but OTOH you can use whichever quoting (including none at all in many cases) you prefer and it just works (provided it's not crazy stuff like Lua's multiline string format or Python's triple quotes). If you want to use double quotes for everything, nothing is preventing you from doing that, but for those of us who don't want to have to hit shift dozens of extra times, it's still accommodating.

Austin got all my points, in special about comments, he didn't express all the hate and loathe that XML deserve, I really "dislike" it with the intensity of a thousand suns. Is basically a machine that converts simple, clear and useful data into a hot mess that you can only hope is somewhat well defined. I applaud his restraint tho, well done sir.

- LocationAustin, TX
- EducationBS Computer Science from Trinity University
- WorkHead of Developer Experience at Camunda
- Joined
"Into a hot mess you can only hope is somewhat well defined"
🤣
That hit me so hard it took me back into my IT days.

- LocationAustin, TX
- EducationBS Computer Science from Trinity University
- WorkHead of Developer Experience at Camunda
- Joined
Thank you for your detailed response!
Comments are key for what we are working on right now. Our configuration files are enormous and if we take away comments it becomes confusing and we can't ship with optional segments disabled.
I know some people love to hate YAML, so as we are building out our products I want to make sure we are making informed decisions about why we choose YAML, or any other config format for that matter.

- Joined
If it's simple enough, I'll just set it as a bunch of environment variables in anrc
file and be done with it.
If I'm working with python or javascript, I'll just create a dict or object in aconfig.{py|js}
file.
For CI pipelines and deployment jobs, I'm kinda used to YAML because CircleCI and I guess the support for multi-line values is quite handy.
Otherwise I guess I would go for JSON, but I haven't had to do that in ages.

- LocationBrussels
- EducationMaster
- WorkDevelopment Manager and Architect
- Joined
I've never understood how JSON was ever accepted as anything except datav transfer notation. One of the biggest misteries in life. I think it was too much of a rebellious drive from the despised by many XML and soap for datac transfer. Suddenly XML was the root of all evil in software.
XML is a bit annoying but functional.
Yaml needs some consistency work. Also I've found be lost inside the structure. Sources are not always the most recognisable element.

I like YAML but it often adds quite a bit of overhead as it's not as universally supported as JSON (many languages will need a library, some basic text editors won't recognize it, you can't pass it directly to your front-end, you can't display it nicely in Firefox...).
So if I don't need the advanced features of YAML I usually stick to JSON. It's just a shame that JSON was conceived only as a data format and thus doesn't support comments and trailing commas, because it would have been a really good configuration format.

- LocationAustin, TX
- EducationBS Computer Science from Trinity University
- WorkHead of Developer Experience at Camunda
- Joined
Honestly supporting comments is really make or break for our product right now.

- LocationTurin, Italy
- WorkSoftware developer
- Joined
Here's a poll I did last week. Most of the users preferred JSON
Davide Bellone 🐧@bellonedavideImagine that#dotnetcore would allow config files to be defined in YAML, JSON or XML. Which one would you prefer?07:04 AM - 03 Apr 2020
oh! I misspelled JSON

- LocationTurin, Italy
- WorkSoftware developer
- Joined
Everyone loves Jon :D

- LocationAustin, TX
- EducationBS Computer Science from Trinity University
- WorkHead of Developer Experience at Camunda
- Joined
Meanwhile I'm typically screaming at JASON

- LocationThailand
- EducationYes
- Joined
Due to lack of real life choices, I have to choose YAML, and sometimes,*.js
; but I like JSON because
- Picky about quotes. Not being picky leads to unexpected behavior.
- Picky about
true
,false
For anything that includes multi-line string, I would have to use YAML. Someone posteda nice tutorial a while ago... There is no alternative, if not for some indentation-based syntax...
For further actions, you may consider blocking this person and/orreporting abuse