{
  "id": "7d8eea3ee147",
  "url": "https://github.com/github/how-engineering-communicates/blob/main/how-github-engineering-communicates.md",
  "title": "How GitHub Engineering communicates",
  "note": "Interesting read from GitHub Engineering on how they desire to communicate amongst each other.\n\n> This document is intended to encourage consistency over preference by outlining a common core of shared internal communication practices for all of Engineering in the form of opinionated guidance, and it was informed by a survey run within the Engineering organization in March 2023. Teams are still encouraged to adapt the practices for their unique circumstances, maintaining a common \"API\" to interface with other teams.\n\nThe key points are:\n\n- Be asynchronous first\n- Write things down\n- Make work visible and overcommunicate\n- Prefer GitHub tools and workflows\n- Embrace collaboration\n- Foster a culture that values documentation maintenance\n- Communicate openly, honestly, and authentically\n- Remember practicality beats purity\n\nThree things that stand out to me:\n\n1. Writing things down, being visible, overcommunicating, being asynchronous are expensive. Getting up on a whiteboard, scribbling in realtime, is fast and cheap. However, you will end up doing that 100 times. If you take the time to \"write things down\" you avoid the repetition.\n2. If you need proof that engineering is a team activity and not a lone coder with a hoody in a dark room, here it is. Nothing of substance gets built by a single person.\n3. Remember that you are communicating with people who have different backgrounds, experiences, and cultures to you. You need to write and structure your thinking in a way that will work across all of those people.\n\nA good representation of \"write things down\" to put this together. ",
  "voice": "mixed",
  "saved": "2023-10-17T02:52:25Z",
  "host": "github.com",
  "kind": "repository",
  "tags": [
    "_feature"
  ],
  "record": "https://links.thingelstad.xyz/links/7d8eea3ee147/",
  "markdown": "https://links.thingelstad.xyz/links/7d8eea3ee147.md",
  "issues": [
    {
      "number": 266,
      "slug": "266",
      "title": "Weekly Thing 266 / Obsessed, DiceRight, Omnivore",
      "date": "2023-10-21T12:00:00Z",
      "section": "Featured",
      "position": 0,
      "url": "https://weekly.thingelstad.com/archive/266/",
      "page": "https://links.thingelstad.xyz/issues/266/"
    }
  ],
  "connections": {
    "same_host": {
      "count": 250,
      "page": "https://links.thingelstad.xyz/hosts/github.com/",
      "nearest": [
        {
          "id": "089a85bdb994",
          "title": "pypipe: Python pipe command line tool",
          "url": "https://github.com/bugen/pypipe",
          "record": "https://links.thingelstad.xyz/links/089a85bdb994/"
        },
        {
          "id": "744f19d9521c",
          "title": "How to (and how not to) design REST APIs · stickfigure",
          "url": "https://github.com/stickfigure/blog/wiki/How-to-%28and-how-not-to%29-design-REST-APIs",
          "record": "https://links.thingelstad.xyz/links/744f19d9521c/"
        },
        {
          "id": "ef8eeffa68db",
          "title": "tailspin: 🌀 A log file highlighter",
          "url": "https://github.com/bensadeh/tailspin",
          "record": "https://links.thingelstad.xyz/links/ef8eeffa68db/"
        },
        {
          "id": "47d65d5baf4d",
          "title": "standard-webhooks",
          "url": "https://github.com/standard-webhooks/standard-webhooks/blob/main/spec/standard-webhooks.md",
          "record": "https://links.thingelstad.xyz/links/47d65d5baf4d/"
        },
        {
          "id": "2a5bdff70645",
          "title": "qsv: CSVs sliced, diced & analyzed.",
          "url": "https://github.com/jqnatividad/qsv",
          "record": "https://links.thingelstad.xyz/links/2a5bdff70645/"
        }
      ]
    },
    "same_week": {
      "count": 19,
      "nearest": [
        {
          "id": "2b8017eb9a2e",
          "title": "Social Internet Is Dead. Get Over It. – On my Om",
          "url": "https://om.co/2023/10/15/social-internet-is-dead-get-used-to-it/",
          "record": "https://links.thingelstad.xyz/links/2b8017eb9a2e/"
        },
        {
          "id": "2218becb5ac2",
          "title": "Omnivore",
          "url": "https://omnivore.app/",
          "record": "https://links.thingelstad.xyz/links/2218becb5ac2/"
        },
        {
          "id": "238f5d838b4b",
          "title": "Words that deserve wider use - Word Warriors - Wayne State University",
          "url": "https://wordwarriors.wayne.edu/list",
          "record": "https://links.thingelstad.xyz/links/238f5d838b4b/"
        },
        {
          "id": "664729d6d131",
          "title": "Ferrari to accept crypto as payment for its cars in the US | Reuters",
          "url": "https://www.reuters.com/business/autos-transportation/ferrari-accept-crypto-payment-its-cars-us-2023-10-14/",
          "record": "https://links.thingelstad.xyz/links/664729d6d131/"
        },
        {
          "id": "dfcbcb8a0e93",
          "title": "Introducing the New Kottke.org Comments",
          "url": "https://kottke.org/23/10/introducing-the-new-kottke-comments",
          "record": "https://links.thingelstad.xyz/links/dfcbcb8a0e93/"
        }
      ]
    },
    "mentions": [],
    "mentioned_by": [],
    "saved_twice": []
  },
  "elsewhere": {
    "wayback": "https://web.archive.org/web/*/https://github.com/github/how-engineering-communicates/blob/main/how-github-engineering-communicates.md"
  }
}