{"id":17330043,"url":"https://github.com/coderbyheart/exploring-better-ways-to-write-tests","last_synced_at":"2026-02-22T18:36:48.797Z","repository":{"id":164472787,"uuid":"639820168","full_name":"coderbyheart/exploring-better-ways-to-write-tests","owner":"coderbyheart","description":"Slides for my talk about improving the tools we use to test the solutions we build","archived":false,"fork":false,"pushed_at":"2023-10-23T07:27:44.000Z","size":5346,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"saga","last_synced_at":"2025-10-23T18:54:06.570Z","etag":null,"topics":["e2e-testing","talk","testing"],"latest_commit_sha":null,"homepage":"https://bit.ly/better-test-tools","language":"Dockerfile","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/coderbyheart.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,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-05-12T09:51:02.000Z","updated_at":"2023-05-15T20:58:01.000Z","dependencies_parsed_at":"2023-10-23T08:30:33.052Z","dependency_job_id":null,"html_url":"https://github.com/coderbyheart/exploring-better-ways-to-write-tests","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/coderbyheart/exploring-better-ways-to-write-tests","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coderbyheart%2Fexploring-better-ways-to-write-tests","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coderbyheart%2Fexploring-better-ways-to-write-tests/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coderbyheart%2Fexploring-better-ways-to-write-tests/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coderbyheart%2Fexploring-better-ways-to-write-tests/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/coderbyheart","download_url":"https://codeload.github.com/coderbyheart/exploring-better-ways-to-write-tests/tar.gz/refs/heads/saga","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/coderbyheart%2Fexploring-better-ways-to-write-tests/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29722024,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-22T15:10:41.462Z","status":"ssl_error","status_checked_at":"2026-02-22T15:10:04.636Z","response_time":110,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["e2e-testing","talk","testing"],"created_at":"2024-10-15T14:50:11.740Z","updated_at":"2026-02-22T18:36:48.771Z","avatar_url":"https://github.com/coderbyheart.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Exploring better ways to write tests\n\n![Publish](https://github.com/coderbyheart/exploring-better-ways-to-write-tests/workflows/Publish/badge.svg?branch=saga)\n\nSlides for my talk about exploring better ways to write tests\n\n- [Markdown](./slides.md)\n- [Interactive](https://coderbyheart.github.io/exploring-better-ways-to-write-tests/index.html)\n\n## Abstract\n\nVery often we focus on improving the way we write tests within our test\nframeworks. I on the other hand invest time into building new test frameworks.\nOver the last years I have worked on\n[end-to-end testing cloud native applications](#it-does-not-run-on-my-machine-integration-testing-a-cloud-native-application),\nwhich lead to the development of a BDD feature runner. This year I took the idea\neven further with a focus on coming closer to the goal of living documentation:\nthe test files are now written in Markdown. In addition I started to work on\nfixing another big issue that we encounter often:\n[our inability to provide good architecture documentation](/twitter/status/1381512195612246018)\n... what we need is not big, huge architecture diagrams for entire systems (like\nwe get when we use C4, Arc42), but diagrams that are context-sensitive. BDD is\nactually a great source for these kinds of diagrams and this is what I want to\nshare in this talk.\n\n### Key take-aways\n\n- that testing, developing and documentation go hand in hand\n- that we as people working on these system need to look at our tools and find\n  ways to improve them\n- ideas on how to build living, understandable, up-date architecture diagrams\n- new ideas about the features of GitHub Actions, traceability and automated\n  diagram generation\n\n## Viewing\n\nAn up-to-date version is published to\n[GitHub pages](https://coderbyheart.github.io/exploring-better-ways-to-write-tests/index.html).\n\nPress `s` to show the speaker notes.\n\n### Locally\n\nOpen the project using\n[Dev Container](https://code.visualstudio.com/docs/remote/containers).\n\nOpen two shells:\n\n1. `npm run watch`\n2. `npm start`\n\nYou can now view the slides at \u003chttp://127.0.0.1:8000\u003e.\n\n## Building\n\nRender to reveal.js:\n\n    make build\n\nRender to PowerPoint (useful for copying to a PowerPoint template):\n\n    make public/slides.pptx\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoderbyheart%2Fexploring-better-ways-to-write-tests","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcoderbyheart%2Fexploring-better-ways-to-write-tests","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcoderbyheart%2Fexploring-better-ways-to-write-tests/lists"}