{"id":13837822,"url":"https://github.com/stevana/armstrong-distributed-systems","last_synced_at":"2025-04-09T22:11:17.667Z","repository":{"id":65540702,"uuid":"583615061","full_name":"stevana/armstrong-distributed-systems","owner":"stevana","description":"Notes on how we potentially could build reliable, scalable and maintainable computer systems.","archived":false,"fork":false,"pushed_at":"2023-09-09T07:11:44.000Z","size":410,"stargazers_count":320,"open_issues_count":0,"forks_count":11,"subscribers_count":14,"default_branch":"main","last_synced_at":"2025-04-09T22:10:54.417Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Makefile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stevana.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2022-12-30T10:27:42.000Z","updated_at":"2025-03-12T00:50:26.000Z","dependencies_parsed_at":"2024-01-13T17:11:36.176Z","dependency_job_id":"9d5c1944-8b04-4e4a-aca4-11dedb43f230","html_url":"https://github.com/stevana/armstrong-distributed-systems","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stevana%2Farmstrong-distributed-systems","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stevana%2Farmstrong-distributed-systems/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stevana%2Farmstrong-distributed-systems/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stevana%2Farmstrong-distributed-systems/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stevana","download_url":"https://codeload.github.com/stevana/armstrong-distributed-systems/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248119294,"owners_count":21050755,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-04T15:01:27.365Z","updated_at":"2025-04-09T22:11:17.649Z","avatar_url":"https://github.com/stevana.png","language":"Makefile","funding_links":[],"categories":["Makefile"],"sub_categories":[],"readme":"# Armstrong distributed systems\n\nHow do we build reliable, scalable and maintainable computer systems?\n\nThis repository contains notes on how, I think, we can improve on the state of\ndevelopment, documentation, testing, deployment, observability, debugging, and\nupgrading of distributed systems. Most of the ideas are stolen from others, many\nfrom Erlang and Joe Armstrong. Over time I hope to turn this into a more\ncoherent text, for now think of it a crude blog or some basic scaffolding for me\nto hang my thoughts on.\n\nIf any of this interests you as well, please do get in touch -- one of the\nreasons I'm writing this down is to find people to collaborate with.\n\n## Development\n\n* [Erlang's not about lightweight processes and message\n  passing...](docs/erlang-is-not-about.md)\n\n* [Implementing\n  behaviours](https://github.com/stevana/armstrong-distributed-systems/blob/implementing-behaviours/docs/implementing-behaviours.md)\n\n* [Modular state machines](docs/modular-state-machines.md)\n\n* Implementing `gen_event` using the LMAX disruptor\n  - https://github.com/stevana/pipelined-state-machines\n  - Shard on: \"people, stuff or deals\",\n    [says](https://youtu.be/1KRYH75wgy4?t=2781) Martin Thompson.\n\n* [State machines with of async I/O](https://github.com/stevana/coroutine-state-machines)\n\n* Persisted/`mmap`ped lock-free concurrent data structures\n  - [Working with binary data](https://github.com/stevana/bits-and-bobs)\n  - bytebuffer\n  - journal\n  - hashmap\n  - arena allocator\n  - buffered actions\n  - [Efficient Tree-Traversals: Reconciling Parallelism and\n    Dense](https://arxiv.org/pdf/2107.00522.pdf)\n\n* [On the role of practice in programming](docs/practice-in-programming.md)\n\n## Documentation\n\n* [Specification language](docs/specification-language.md)\n  - Interfaces\n  - Messages\n  - Compression\n  - Protocols\n  - Usage model or operational profile\n\n* Joe's idea of [\"the bigger picture\"](https://youtu.be/h8nmzPh5Npg?t=1220) in\n  particular the \"research\" part, not just the end result (code) but how you got\n  to the result.\n\n## Testing\n\n* [Simulation testing using state\n  machines](https://github.com/stevana/property-based-testing-stateful-systems-tutorial)\n\n* Usage model or operational profile\n\n* Load/soak testing\n\n## Deployment\n\n* [Deploying and restarting state machines using supervisor\n  trees](https://github.com/stevana/supervised-state-machines)\n\n* [Elastically scalable thread\n  pools](https://github.com/stevana/elastically-scalable-thread-pools)\n\n## Observability\n\n* [Visualising datastructures over time using\n  SVG](https://github.com/stevana/svg-viewer-in-svg)\n\n## Debugging\n\n* [Domains-specific debuggers](docs/domain-specific-debuggers.md)\n\n## Upgrading\n\n* [Hot-code swapping à la Erlang with `Arrow`-based state\n  machines](https://github.com/stevana/hot-swapping-state-machines)\n\n* [`smarrow-lang`](https://github.com/stevana/smarrow-lang) an experimental\n  programming language where programs are state machines expressed in arrow\n  notation to allow easy hot-code swapping\n\n* Version everything\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstevana%2Farmstrong-distributed-systems","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstevana%2Farmstrong-distributed-systems","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstevana%2Farmstrong-distributed-systems/lists"}