Software Engineering
====================

Development
-----------

* https://conventionalcomments.org/
* https://www.conventionalcommits.org/


Infrastructure
--------------

* `Artificial Intelligence Infrastructure-as-Code Generator <https://github.com/gofireflyio/aiac>`_
* `7 Core Elements of an Internal Developer Platform <https://thenewstack.io/7-core-elements-of-an-internal-developer-platform/>`_
* `How to make an Impact as a Platform Product Manager <https://theplatformspace.substack.com/p/how-to-make-an-impact-as-a-platform>`_
* `Automating safe, hands-off deployments <https://aws.amazon.com/builders-library/automating-safe-hands-off-deployments/>`_
* `Awesome Load Management <https://github.com/StanzaSystems/awesome-load-management>`_
* `The Service Mesh Landscape <https://layer5.io/service-mesh-landscape>`_


DevOps
------

* `DevOps uses a capability model, not a maturity model <https://octopus.com/blog/devops-uses-capability-not-maturity>`_


Metrics / Observability
-----------------------

* `You Only Get 3 Metrics - Which Ones Would You Pick? <https://www.philvenables.com/post/you-only-get-3-metrics-which-ones-would-you-pick>`_
* `OpenTelemetry Tracing in 200 lines of code | Jeremy Morrell <https://jeremymorrell.dev/blog/minimal-js-tracing/>`_


Misc
----

* `Read Every Single Error <https://www.pulumi.com/blog/reducing-our-error-rate/>`_
* `Explaining <https://codeinthehole.com/tips/explaining/>`_
* `Amir’s 10 Laws of Tech <https://medium.com/swlh/amirs-10-laws-of-tech-64536bf8eeff>`_
* `How To Get Buy-in for DevEx Initiatives: Strategies From GitHub, Notion, and More <https://getdx.com/resources/devex-executive-buy-in>`_
* `My Approach to Building Large Technical Projects <https://mitchellh.com/writing/building-large-technical-projects>`_
* `Page Weight Matters <https://blog.chriszacharias.com/page-weight-matters>`_
* `All the Hard Stuff Nobody Talks About when Building Products with LLMs <https://www.honeycomb.io/blog/hard-stuff-nobody-talks-about-llm>`_
* `Introducing "Implement DNS in a Weekend" <https://jvns.ca/blog/2023/05/12/introducing-implement-dns-in-a-weekend/>`_
* `A beginner-friendly introduction to Kubernetes <https://medium.com/@himeshikaabayaratne/a-beginner-friendly-introduction-to-kubernetes-c0c402e8f39c>`_
* `Lullaby Language <http://www.humansystemsinaction.com/lullaby-language/>`_
* `Talk Like A Systems Engineer: Yaks All The Way Down <https://flameeyes.blog/2022/04/26/engineering-jargon-yaks/>`_
* `Ditherpunk — The article I wish I had about monochrome image dithering <https://surma.dev/things/ditherpunk/>`_
* `Whose Cert Is It Anyway? <https://www.netmeister.org/blog/caa-diversity.html>`_
* `Netreap: A Practical Guide to Running Cilium in Nomad <https://cosmonic.com/blog/engineering/netreap-a-practical-guide-to-running-cilium-in-nomad>`_
* `Building Customer-Facing Real-Time Dashboards with Postgres <https://www.crunchydata.com/blog/building-customer-facing-real-time-dashboards-with-postgres>`_
* `llm, ttok and strip-tags—CLI tools for working with ChatGPT and other LLMs <https://simonwillison.net/2023/May/18/cli-tools-for-llms/>`_
* `Task <https://taskfile.dev/>`_
* `DevEx: What Actually Drives Productivity <https://queue.acm.org/detail.cfm?id=3595878>`_
* `Language Tooling Antipatterns <https://borretti.me/article/language-tooling-antipatterns>`_
* `Technology Decision Making (and Boring Technology) <https://code.likeagirl.io/technology-decision-making-and-boring-technology-e6cbe612450f>`_
* `What is Technical Debt? <https://lauratacho.com/blog/what-is-technical-debt>`_
* `Refactoring CI/CD for a Moderately Large C++ Code Base <https://robertu94.github.io/2023/04/24/refactoring-ci/cd-for-a-moderately-large-c-code-base.html>`_
* `Levelling up Pull Requests <https://www.brautaset.org/posts/levelling-up-pull-requests.html>`_
* `Agility and Architecture: Balancing Minimum Viable Product and Minimum Viable Architecture <https://www.infoq.com/articles/agility-architecture/>`_
* `User Story Template: What It Is and Why It Works So Well <https://www.mountaingoatsoftware.com/blog/why-the-three-part-user-story-template-works-so-well>`_
* `Avoiding the Rewrite Trap <https://skamille.medium.com/avoiding-the-rewrite-trap-b1283b8dd39e>`_
* `Should You Use Upper Bound Version Constraints? - <https://iscinumpy.dev/post/bound-version-constraints/>`_
    * "Capping dependencies has long term negative effects, especially for libraries, and should never be taken lightly. A library is not installed in isolation; it has to live with other libraries in a shared environment. Only add a cap if a dependency is known to be incompatible or there is a high (>75%) chance of it being incompatible in its next release. Do not cap by default - capping dependencies makes your software incompatible with other libraries that also have strict lower limits on dependencies, and limits future fixes. Anyone can fix a missing cap, but users cannot fix an over restrictive cap causing solver errors. It also encourages hiding issues until they become harder to fix, it does not scale to larger systems, it limits your ability to access security and bugfix updates"
* `Tech debt metaphor maximalism - apenwarr <https://apenwarr.ca/log/20230605#>`_
* `DevOps Notebooks Built with Markdown <https://runme.dev/>`_
* `googleapis/release-please: generate release PRs based on the conventionalcommits.org spec <https://github.com/googleapis/release-please>`_