cratermoon

Writing is an essential skill for software developers.

Software documentation should cover the development and engineering decisions, not the code. It should explain why and how it was built and is maintained. An ideal to strive for is making it possible to recreate the system from scratch, without access to the code, should it be necessary.

Technical documentation for any software system should include:

• A logical model of the domain
• logical architecture schema
• physical architecture schema

cratermoon

title	author	date	lastModified	lang
Experienced Developer Notes	Steven E. Newton	2022-11-12 04:56:49 -0800	2024-06-18 12:13:05 -0700	en-US

The last thing a programmer should be worried about is how fast they can type in code.

Everything is a people problem when you dig deep enough.

cratermoon

/********* Sample code generated by the curl command line tool **********
 * All curl_easy_setopt() options are documented at:
 * https://curl.se/libcurl/c/curl_easy_setopt.html
 * curl -s --libcurl github.c https://github.com
 ************************************************************************/
#include <curl/curl.h>

int main(int argc, char *argv[])
{
  CURLcode ret;

cratermoon

cratermoon

• If I subsequently regret making the move to management, what is my way back to a hands-on technical role?
• Don't layoffs hit middle management first?
• Why not Rachel or Marya?
• What support for new managers is there and who supports me?
• Who is my manager?
• How big is my team? Do I get any say who is on it?
• Is there an intermediate step? Offically recognized mentor and leader that isn't straight up management?
• What happens when I have to fire someone? Who do I work with in HR for personnel issues?

cratermoon

const fs = require('fs');

for (i = 0; i < 1000; i++) {
  var appid = Math.floor(Math.random() * (531480 - 5)) + 5;
  var ds = (new Date()).toISOString().replace(/[^0-9]/g, "")
  var filename = appid + "_" + ds + "_1.png";
  fs.open(filename, "w",   (err, fd) => {
      fs.close(fd, console.log);
    }
  );