Software & Tools overview

73 topics in 14 lessons, each in one line. Every topic opens the page that teaches it.

After this course you can

  • Follow a change from source code to a running service, and name every stage it passes through.
  • Read and write enough Python, JSON and YAML to automate a task, and keep the work in Git with others.
  • Explain how an API, a CLI, Terraform and a CI/CD pipeline each drive a platform, and when to use which.

1How software is built and shipped

2Programming basics with Python

3Python: data, files and errors

4Data formats

5Version control with Git

6Branching and merging

7Working together on GitHub

8APIs

9CLIs and SDKs

10Infrastructure as code

11CI/CD pipelines

12Testing and code quality

13Debugging and working with AI tools

14One line to productionWorked case

Sources and credit

36 sources

The chapters and drawings are written by NeuroqAI from these sources. Each lesson lists its own at the end of its chapter, and figures on the pages are taken from them or computed from them.

GitHub6 sourcesAbout pull requestsReviews, merges and checks on GitHubLesson 7About protected branchesRules that stop changes skipping reviewLesson 7GitHub REST API documentationA typical real API: pagination and rate limitsLesson 8GitHub CLI manualGitHub from the terminalLesson 9GitHub Actions documentationWorkflows, jobs, runners, secrets and environmentsLesson 11Security hardening for GitHub ActionsSecrets, pinned actions and OpenID ConnectLesson 11
IETF (RFC Editor)4 sourcesRFC 8259: The JavaScript Object Notation (JSON) Data Interchange FormatJSON exactly as standardisedLesson 4RFC 4180: Common Format and MIME Type for CSV FilesQuoting and commas in CSVLesson 4RFC 9110: HTTP SemanticsMethods, status codes and which methods are safe to repeatLesson 8RFC 6749: The OAuth 2.0 Authorization FrameworkAccess tokens and how clients get themLesson 8
HashiCorp3 sourcesTerraform documentationProviders, resources, state, plan and modulesLesson 10Terraform stateWhat the state file holds, and why it must be locked and protectedLesson 10What is Terraform?Infrastructure as code across any providerLesson 10
Standards, research and other publishers23 sourcesThe Twelve-Factor App · Adam WigginsCodebase, dependencies, config, build-release-runLessons 1, 4Semantic Versioning 2.0.0 · semver.orgWhat a change in each part of a version number promisesLesson 1Python Packaging User Guide · Python Packaging AuthorityInstalling packages and virtual environmentsLessons 1, 3The Python Tutorial · Python Software FoundationThe language from the people who make itLessons 2, 3The Python Language Reference · Python Software FoundationThe exact rules: data model, assignment, truthLesson 2YAML 1.2.2 specification · yaml.orgYAML's rules, and how 1.2 differs from 1.1Lesson 4TOML v1.0.0 · toml.ioA config format with no surprises in its typesLesson 4JSON Schema · json-schema.orgChecking that a document has the shape you expectLesson 4Pro Git, 2nd edition · Scott Chacon and Ben StraubThe free book on Git, from objects to rebasingLessons 5, 6, 7Git reference · Git projectEvery Git command and its optionsLessons 5, 6AWS Command Line Interface user guide · Amazon Web ServicesCommand structure, profiles and where credentials come fromLesson 9Boto3 documentation · Amazon Web ServicesThe AWS SDK for PythonLesson 9Azure CLI documentation · MicrosoftThe az commandLesson 9gcloud CLI overview · Google CloudThe gcloud commandLesson 9Canary release · Martin FowlerRelease to a few users firstLessons 11, 14Blue-green deployment · Martin FowlerTwo environments, switch the trafficLesson 11Canarying releases (The Site Reliability Workbook) · GoogleHow Google judges a canary before rolling onLessons 11, 14The practical test pyramid · Martin Fowler (Ham Vocke)Many fast tests, few slow onesLessons 12, 13pytest documentation · pytestWriting and running Python testsLessons 12, 13, 14How to do a code review · GoogleWhat a reviewer looks for, and in what orderLessons 12, 13OWASP Top 10 for Large Language Model Applications · OWASPThe main risks when software uses an AI modelLessons 12, 13In the Matter of Knight Capital Americas LLC (Release 34-70694) · U.S. Securities and Exchange CommissionThe SEC order: one of eight servers missed a deployment and a reused flag woke old codeLesson 14os.environ · Python documentationThe environment as a mapping of strings to stringsLesson 14