When asked, "What language should I learn first?", my answer is always "English". If you can't communicate clearly then you can't do your job as a programmer properly. As a programmer your job does not begin and end with code. You must also be able to write documentation clearly. I recently came across two excellent technical writing modules by Google that are free for everyone. They do not take long to complete and (aside from the confusion between acronyms and initialisms) are spot on. You can find the overview here with links to the two main modules.
A lot of you are shut in for the duration of the Covid-19 outbreak anyway so you have no reason not to at least have a look.
Have you ever noticed that the website you have for your business isn’t really performing the way it should be? Maybe the design isn’t attractive, the traffic is poor, and you have no idea why this is happening. The reason is pretty simple. The website was designed by an amateur, or maybe it was you […]
Graphic designers, or graphic craftsmen, make visual graphics that are proposed to pass on a message to the crowd. Designers make graphics for sites and games just as motion picture media. Graphic designers additionally use photography and photography to make formats for print media. Advertising organizations regularly request that graphic designers assist them with making […]
One of the most effective and simple ways to measure the performance of the website or manage the ROI is by setting up the conversion goals. To set your conversion goals, you can use a tool like Google Analytics. So, every time a visitor engages with a website, a conversion can be measured. Why […]
Hello everyone! This is for sure not the best context to meet again, we can just hope you guys are safe and healthy. We relate to each other now since most of us are in the same situation, trying to cope with sudden changes and new daily routines. I personally see it as a lesson that will teach us many positive things by the end of this unpleasant period.
The Allen Institute for AI has introduced the COVID-19 Open Research Dataset (CORD-19). CORD-19 is a free, open-source database that includes 45,000 scholarly articles about COVID-19 and the coronavirus family of viruses. The goal is to streamline access to this pertinent set of resources to the research community around the world.
I’ve written up my advice (sprinkled with great advice from others), but this is way more straightforward nuts-and-bolts training on technical writing. It’s structured like an actual course, with exercises along the way.
I’m far from an expert here. But between Geoff and I, we end up doing a lot of technical article editing for the sake of clarity.
Comedy writers seek the funniest results, horror writers strive for the scariest, and technical writers aim for the clearest. In technical writing, clarity takes precedence over all other rules.
It can be tricky to get right. Read the section on Active voice. That’s easy for anyone to get wrong.
Essentially every single rule is just an extension of “make it more clear.”
Justin Duke asks if treating code comments like footnotes could help us understand the code in a file better. In his mockup, all the comments are hidden by default and require a click to reveal:
What a neat idea! Justin’s design reminds me of the way that Instapaper treated inline footnotes.
I guess the reason I like this idea so much is that a lot of comments don’t need to be read constantly, — they’re sort of a reminder that, “Hey, this needs work in the future” or “Yikes, this is weird and I’m sorry.” Keeping these comments out of the code makes it much easier to scan the whole file, too.
I do wonder if there could be a toggle that shows every comment, just in case you need to read all the comments in sequence rather than clicking to toggle each one.
Anyway, all this talk about comments reminds me of an absolutely fantastic talk by Sarah Drasner at JSConf this year where she discussed why comments are so dang hard to get right:
Arduino, maker of credit-card sized computers that are easily adapted in Internet-of-Things (IoT) fashion to standalone analog or digital devices, has put out a call to all developers, researchers, doctors, academics, IT pros and other innovators to join a virtual conference today (April 2, 2020) on battling COVID-19 with Arduinos. For example, building Arduino-based ventilators.
WordPress is being used by millions and, as the Coronavirus circles the world, it is impacting the WordPress industry overall. At the beginning of this pandemic, I was interested to see how various WordPress entities are being affected, so I’ve reached out to business leaders and independent professionals in our industry to learn what they’re doing to keep things going.
INSERT INTO table
VALUES (...)
ON DUPLICATE KEY UPDATE
id = LAST_INSERT_ID(id),
...
id is a PRIMARY KEY.
My question is that I can't for anything remember why I have id = LAST_INSERT_ID(id). I wrote it years ago and it's not commented. Can anyone think of a reason why I was doing this?
The other day, I realized that web performance is an enormous topic covering so very much — from minimizing assets to using certain file formats, it can be an awful lot to keep in mind while building a website. It’s certainly far too much for me to remember!
So I made a web performance checklist. It’s a Notion doc that I can fork and use to mark completed items whenever I start a new project. It also contains a bunch of links for references.
This doc is still a work in progress. Any recommendations or links?Feel free to suggest something in the comments below!
Farm Market ID, agriculture business intelligence provider, has announced a new, real-time API. The API allows third party developers access to Farm Market ID's rich agribusiness data. The goal is to bring all data that farms have an interest in under one umbrella where developers can integrate the data as needed. This includes farm, farmer, crop, farm field, and market data.