Encoding it into your source file has positive externalities. If you're using source control, the comment controlling the linter is tracked alongside the rest of your code. You can track who added it and why. You can share this comment with other engineers on your team.
You could also imagine other representations of the same data (e.g. one large file which includes annotations, or a binary representation). But in this case you lose colocation with the code they're annotating, so it's more likely to drift.
I fully agree that there are probably better UX's out there for this flow, but the source annotation approach is popular for very good reasons.
We recently just deployed Traefik at $job, and found it pretty easy! I didn't do the work myself, but I directly managed the engineer deploying it. It was predominantly reference material but that was really all we needed to get it set up.
Half Dutch half American. I find the Dutch complain a decent bit more, but I find that there is more to complain about in the States. Maar wat is het leven zonder klagen?
One thing I've noticed being back recently: cost of living has gotten very unaffordable in Amsterdam the last time I was back. Cost of basic goods is on par with what I'm used to paying in major American cities, but my Dutch relatives often earn a decent bit less. I wonder if this will affect Dutch happiness in future surveys once affordability exceeds more and more people's earnings.
My understanding is that as part of the Amtrak Improvement Act[1] Amtrak is given preference over freight rail, even on private track. However only the Department of Justice may enforce this, which it has done only once.
Fair warning I haven't read the text of the law in full, only heard this second hand.
You could also imagine other representations of the same data (e.g. one large file which includes annotations, or a binary representation). But in this case you lose colocation with the code they're annotating, so it's more likely to drift.
I fully agree that there are probably better UX's out there for this flow, but the source annotation approach is popular for very good reasons.