> The sector contributed 0.25% to GDP and enabled savings on consumers' electricity bills of more than 4.6 billion euros in 2024, with an average reduction in the wholesale price of close to 20 euros per MWh.
Fresh pasta is an entirely different beast from dried pasta, so the two are hard to compare. I never made dried pasta at home, but I find it impossible (even in Italy) to buy fresh gnocchi that are as good as the ones that you can make at home.
"Remove half of the signs, they become outdated whenever we change the roads"
Software is written by humans for humans, and documentation is a fundamental part of it, and needs maintenance just like the rest. It is beyond me why one would want to maintain only half of the thing and say "discard the rest"
Which specific points in the post did you disagree with? "Just keep the documentation up-to-date" sounds about as practical as saying "just don't write bugs."
The impact and importance of documentation varies from project to project, but it is hard to see these hard-line takes on the importance of documentation as anything more than grandstanding. In the real world, where consumers and businesses exchange money for goods and services, and where organizations, individuals and teams must wrestle with market conditions, deadlines, KPIs and so on, documentation is a supporting act.
> "Just keep the documentation up-to-date" sounds about as practical as saying "just don't write bugs."
And that’s why nobody ever bothers with type checkers, code reviews, unit tests, CI and fuzzing in order to prevent, detect and fix bugs before shipping to production. You’re right, it’s totally impractical to apply any discipline to software development.
The idea isn't "put no effort into keeping documentation up to date." It's to acknowledge that, in the real world, documentation does go out of date despite the best efforts of project maintainers. Sticking our fingers in our ears and saying "just keep it up to date then" is simply not a real position.
Despite a huge volume of tooling and methodology around reducing bugs, bugs still exist. This is a reality. One with associated costs and mitigations that we acknowledge. Likewise, the article is suggesting we acknowledge the reality that documentation does go out of date, even when effort is being put into maintaining it. That's why the point immediately preceding "It gets outdated" is "It requires maintenance" ;)
And that's what the post is about. To avoid writing bugs, you add type checkers, unit tests, DRY and other principles that you sometimes ignore (once you're experienced enough).
Clearly, you're talking about the same thing. TFA basically say 'to keep the documentation up to date, you need discipline, here's what I do'. Unironically, the 10th point I never thought about, and will immediately apply
This is unironically a valid approach adopted in many places. That's the basic philosophy behind putting curves and road blocks to lower driving speed instead of imperative signs that people ignore.
Or making sure there's visibility in a turn instead of putting obnoxious warning signs etc.
I am all for improving the conditions so that signs can be removed (and this is valid with code too, e.g. a strong type system removes the need for a lot of documentation), but again we should not advocate for not documenting things, that's just asking for trouble.
And speaking of signs, we definitely don't have a good balance there either - in some places I experienced confusing situations where adding a few more signs could have helped.
The same can of course apply to code: there's many instances where someone will assume they understand a tricky bit of code because they read a well written comment. That's a bad sign, as the code probably had a lot more nuance that was not covered by the commenter. And then did they properly understand what the comment is saying ? we now have a two level readability problem.
In general, I sympathize with the approach that making it easier for people to understand shouldn't happen in comments. It's frustrating for the people reading the code, but we're paid professionals, and frustration is better to me than lack of understanding or glossing over the actual behavior (I'd trade fewer bugs for hurt feelings any day)
Comments should bring additional info that complements the code in a meta way (link to bug reports, design documents, discussion threads etc.)
Update the road and make it safe and clear to use before removing the signs. Don’t tell road builders that they can avoid placing signs because most road builders don’t build clear roads.
Here in New South Wales, Australia, we switched to European-style alphanumeric route numbers about 10 years ago. You can still see signs with the old-style route numbers (just numeric, and inside either a shield symbol or a hexagon symbol) in more than a handful of places around Sydney.
If you look hard enough (mainly confined to secondary rural roads these days), you can also still find signs with distances in miles. Australia switched to kilometres about 50 years ago.
I am sure that people who design roads worry about distracting drivers with too many signs. In any case, when one sees five road signs in twenty meters of road, one is lucky if one of them registers. It is very unfortunate when similar worry does not occur with too many comments. It is quite possible to completely clutter out of view anything meaningful by writing too many comments.
> I am sure that people who design roads worry about distracting drivers with too many signs
I wish this was the case where I live.
You want, as a driver, the roads to be boring, as you are probably much better at recognizing patterns than reading signs.
But no, in Germany, they are busy optimizing for something I'm yet to discover (neither flow nor security, that I'm sure of) and every !! city is a new adventure with 1000 signs every corner.
Sure, but then the advice we should give is "please please document the WHY", rather than "stop commenting"
In any case, I personally find it very useful when I come to a new piece of code to find comments that summarise what it's happening in a few words without having to parse 10-100 lines of dense implementation - I have so much cognitive ability I can apply in one day, and any effort to optimise its usage should be welcome
Those signs usually say the current kilometer you are on the road, which is extremely useful to report accidents or damage to the road or surrounding structures with large accuracy. This was specially relevant before everyone had a GPS receiver in their pocket, but is still useful - it's still easier for police or firefighters to go to X km on some road then to a GPS waypoint as its easier to communicate verbally and more likely that people will immediately know how to get there. Not sure about every 20feet though, different countries have different distances (every 100 meters in some).
Actually no, I'm a city boy and use public transport. But delineators are not what I'm talking about, rather signs which say "this is a road" every 20 feet, those don't exist since they would be entirely pointless, like comments which mirror (hopefully) the line of code that follows.
There's a thing that happens when you start coding, you put comments next to the sharp corners to remind you what it does (because your code is obscure and non-obvious, you've just started doing this), then you want it to look tidy and professional, and occasional comments look unbalanced, asymmetric, so you add comments on the obvious bits to give a nice uniform look to it. You end up with
// say hello
printf("This is foo (version %s)\n", VERSION);
I'm as guilty of this as everyone else. The OP is saying try to avoid that, comments have a maintenance cost.
Oh, I'm not talking about comments, but literally road signs.
I've seen plenty of these comments myself in various states of correct- and usefulness (from right and helpful to redundant to wrong, because of a change to always been wrong) in the last (almost) 20 years. Some of them had been my own.
In all the Haskell teams I worked in, the candidate knowing Haskell was rarely a significant advantage (except for cases where the most experienced Haskeller leaves, and then you need to hire someone to direct your GHC-internals questions to).
If you are interested in a job using a functional language you can pick basically any of them and then jump ship to a different one. I wrote Clojure for many years before switching to Haskell.
> As for myself, I think what foods I choose to consume are none of the government's business
There is a difference though: it's not about choice as much as it is about "good defaults". As a state you should want your folk to have better food, but if some person wants the choice of micromanaging their diet then sure, go ahead.
I shouldn't be struggling to find non-processed food in a supermarket. This is often the case right now, which is why I would very much welcome some more regulation on this.
> I shouldn't be struggling to find non-processed food in a supermarket. This is often the case right now, which is why I would very much welcome some more regulation on this.
What supermarkets do you go to that don't have a produce section and a meat section? Is there some other form of unprocessed food you expect?
Even something like pasta and bread are technically processed (but maybe not ultraprocessed unless its wonderbread)
Surely don't all supermarkets sell potatoes, carrots, green vegetables, fruit, nuts, minimally processed cereals (husk removal and cleaning), fresh meat, fish, cheese, eggs and dairy products including naturally processed cheeses?
I wonder if the term 'micromanaging [their diet]' is a touch perjorative. Given the prevalence of serious chronic diseases which are reported to be strongly linked to what you eat, shouldn't everyone be encouraged to take a serious look at how to 'macro' manage their diet, an action which is almost certainly likely to improve quality of life and maybe life span?
I would like to play more, but the games seem to be unreliable - the moves from my opponents stop getting through at some point, typically after a few moves.
I've been fighting with the automatic accumulation of downloads for years now - it really makes it impossible to figure out if whatever I downloaded can safely be deleted - so my current system is similar to the OP's one, but a little gentler: I have a launchd task that runs every day and warns "I'm about to delete these things that are older than two weeks", which lets me salvage anything I might have forgotten to archive.
I've been looking into this (thanks for the pointer to Sensitronics!), do you have any pointers to a manufacturer of squishy material pads? (silicone I guess)
Sensitronics was recommended to me by Roger Linn one time I met him when he happened to be in town for an event. They apparently make the sensor in the Linnstrument.
What I do is I glue a sheet of 1/8th inch birch ply to a sheet of felt using liquid hide glue, then use a laser cutter to cut that into keys. (They're irregular polygons, but you could do the same easily with squares.) I have another piece of laser cut plywood (or the "negative space" of the same plywood, but with the felt removed) that serves as a frame to hold the keys in place. I use packing tape on the back of the frame, sticky side up, to grab onto the felt so they don't all fall out when you turn it upside-down. The felt gives the keys a satisfying squishy feel. Wood screws hold it all together.
In other words, from top to bottom a key is comprised of 1/8th inch birch ply, a layer of glue, a layer of felt, a layer of tape sticky side up, a layer of FSR film, then ENIG-coated copper traces on an FR4 PCB with the solder mask excluded. I also have another layer of plywood (1/4") on the bottom for structure.
I made an early attempt at using some kind of silicone rubber, but I wasn't successful. It might be doable and I imagine there are companies that can make that stuff for you but in the end I decided I liked wooden keys better and they were just plain easier.
I don't have leds on the keys, but if you want that, WS2812's are surprisingly cheap and could be placed by a pick-and-place machine by the hundreds -- if you can figure out a way to get the light to shine through all the intervening opaque parts.
> The sector contributed 0.25% to GDP and enabled savings on consumers' electricity bills of more than 4.6 billion euros in 2024, with an average reduction in the wholesale price of close to 20 euros per MWh.