{"id":19293533,"url":"https://github.com/voschezang/coding-handbook","last_synced_at":"2026-03-02T06:30:57.165Z","repository":{"id":54566816,"uuid":"365722694","full_name":"voschezang/coding-handbook","owner":"voschezang","description":"Conjectures about Software Development \u0026 Human Behaviour","archived":false,"fork":false,"pushed_at":"2025-09-25T13:41:09.000Z","size":31267,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-25T15:36:23.048Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/voschezang.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-05-09T10:13:13.000Z","updated_at":"2025-09-25T13:41:13.000Z","dependencies_parsed_at":"2023-02-15T06:46:22.342Z","dependency_job_id":"80c15d13-5605-41d0-a522-d16cf275574a","html_url":"https://github.com/voschezang/coding-handbook","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/voschezang/coding-handbook","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voschezang%2Fcoding-handbook","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voschezang%2Fcoding-handbook/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voschezang%2Fcoding-handbook/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voschezang%2Fcoding-handbook/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/voschezang","download_url":"https://codeload.github.com/voschezang/coding-handbook/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/voschezang%2Fcoding-handbook/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29994120,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-02T01:47:34.672Z","status":"online","status_checked_at":"2026-03-02T02:00:07.342Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2024-11-09T22:35:19.474Z","updated_at":"2026-03-02T06:30:56.559Z","avatar_url":"https://github.com/voschezang.png","language":"HTML","readme":"# Coding Handbook\n\nThis respository is a collection of ideas about collaboration, in written and visual form. It connects experience, society and software engineering. It is used as a tool for learning - to map out ideas. It is meant to provoke discussion, rather than to offer in-depth explanations.\n\n*Disclaimer: this repository does not contain advice.*\n\n## Index\n\nSee [index](index.md).\n\n## Table of Contents\n\nModels\n\n\u003cdetails\u003e\n\u003csummary\u003eTheory: \u003cb\u003eDomain modelling\u003c/b\u003e (of real world concepts)\u003c/summary\u003e\n\u003cul style=\"margin: 1em;\"\u003e\n\u003cli\u003e\u003ca href=\"domain-modelling/domain-driven-design.md\"\u003eDomain-Driven-Design\u003c/a\u003e- examples of DDD using OOP and FP.\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"domain-modelling/relations.md\"\u003eFunctions and Relationships\u003c/a\u003e\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"domain-modelling/programming-patterns.md\"\u003eProgramming Patterns\u003c/a\u003e - common programming, application and system architecture patterns.\u003c/li\u003e\n\u003c/ul\u003eo\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003ePractice: \u003cb\u003eComputer language\u003c/b\u003e (encoding of models)\u003c/summary\u003e\n\u003cul style=\"margin: 1em;\"\u003e\n\u003cli\u003e\u003ca href=\"computer-languages/style-guide.md\"\u003eStyle Guide\u003c/a\u003e - a prescriptive guide for programming (low level)\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"computer-languages/language-spec.md\"\u003eLanguage Specification\u003c/a\u003e - this can be implemented as a library or a new language.\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"computer-languages/programming-patterns-functional.md\"\u003eFunctional Programming Patterns\u003c/a\u003e\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"computer-languages/programming-paradigms.md\"\u003eProgramming Paradigms\u003c/a\u003e - a comparison of OOP and FP.\u003c/li\u003e\n\u003c/ul\u003e\n\u003c/details\u003e\n\nSystems\n\n\u003cdetails\u003e\n\u003csummary\u003eTheory: \u003cb\u003eSystems\u003c/b\u003e (internal view).\u003c/summary\u003e\n\u003cul style=\"margin: 1em;\"\u003e\n\u003cli\u003e\u003ca href=\"systems/system.md\"\u003eSystems\u003c/a\u003e and organization\u003c/li\u003e\n\u003cul style=\"margin: 0;\"\u003e\n  \u003cli\u003e\u003ca href=\"systems/structure.md\"\u003eStructure\u003c/a\u003e and topology\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"systems/relations.md\"\u003eRelations\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"systems/scale.md\"\u003eScale\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"systems/platform\"\u003ePlatforms\u003c/a\u003e\u003c/li\u003e\n\u003c/ul\u003e\n\u003cli\u003e\u003ca href=\"systems/systems-management.md\"\u003eSystems\u003c/a\u003e Management\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"systems/communication-patterns.md\"\u003eCommunication Patterns\u003c/a\u003e for humans and computers\u003c/li\u003e\n\u003c/ul\u003e\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003eTheory: \u003cb\u003eSubjects\u003c/b\u003e (functional view).\u003c/summary\u003e\n\u003cul style=\"margin: 1em;\"\u003e\n\u003cli\u003e\u003ca href=\"subjects/identity.md\"\u003eIdentity\u003c/a\u003e\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"subjects/change.md\"\u003eBehaviour\u003c/a\u003e\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"subjects/activity.md\"\u003eActivity\u003c/a\u003e\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"labour/goals.md\"\u003eGoals\u003c/a\u003e\u003c/li\u003e\n\u003c/ul\u003e\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003ePractice: \u003cb\u003eLabour\u003c/b\u003e (organization of work)\u003c/summary\u003e\n\u003cul style=\"margin: 1em;\"\u003e\n\u003cli\u003e\u003ca href=\"labour/labour.md\"\u003eLabour\u003c/a\u003e\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"labour/terminology.md\"\u003eTerminology\u003c/a\u003e\u003c/li\u003e\n\t\u003cul style=\"margin: 0;\"\u003e\n\t  \u003cli\u003e\u003ca href=\"labour/products-projects-initiatives.md\"\u003eProducts, projects, initiatives\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"labour/lifecycle.md\"\u003eProduct Lifecycle\u003c/a\u003e\u003c/li\u003e\n  \u003c/ul\u003e\n\u003cli\u003e\u003ca href=\"labour/realization.md\"\u003eRealization\u003c/a\u003e\u003c/li\u003e\n\u003cul style=\"margin: 0;\"\u003e\n\t\u003cli\u003e\u003ca href=\"labour/discovery.md\"\u003eDiscovery\u003c/a\u003e\u003c/li\u003e\n  \u003cul style=\"margin: 0;\"\u003e\n    \u003cli\u003e\u003ca href=\"labour/goals.md\"\u003eGoals\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"labour/planning.md\"\u003ePlanning\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"labour/bets.md\"\u003eBets\u003c/a\u003e\u003c/li\u003e\n  \u003c/ul\u003e\n\t\u003cli\u003e\u003ca\u003eDelivery\u003c/a\u003e\u003c/li\u003e\n  \u003cul style=\"margin: 0;\"\u003e\n    \u003cli\u003e\u003ca href=\"labour/increments.md\"\u003eIncrements\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"labour/initiatives.md\"\u003eInitiatives\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"labour/project-requirements.md\"\u003eProject Requirements\u003c/a\u003e\u003c/li\u003e\n  \u003c/ul\u003e\n\u003c/ul\u003e\n\u003c/ul\u003e\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003ePractice: \u003cb\u003eManagement\u003c/b\u003e of systems\u003c/summary\u003e\n\u003cul style=\"margin: 1em;\"\u003e\n\u003cli\u003e\u003ca href=\"management/management-principles.md\"\u003ePrinciples\u003c/a\u003e\u003c/li\u003e\n\u003cul style=\"margin: 0;\"\u003e\n  \u003cli\u003e\u003ca href=\"management/product-management.md\"\u003eProduct Management\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"management/project-management.md\"\u003eProject Management\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"management/change-management.md\"\u003eChange Management\u003c/a\u003e\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"management/risk-management.md\"\u003eRisk Management\u003c/a\u003e\u003c/li\u003e\n\u003c/ul\u003e\n\u003cli\u003e\u003ca href=\"management/goal-templates.md\"\u003eGoals setting\u003c/a\u003e\u003c/li\u003e\n\u003c/ul\u003e\n\u003c/details\u003e\n\nTechnological\n\n\u003cdetails\u003e\n\u003csummary\u003eTheory: \u003cb\u003eMath\u003c/b\u003e\u003c/summary\u003e\n\u003cul style=\"margin: 1em;\"\u003e\n\u003cli\u003eMathematical \u003ca href=\"math/models.md\"\u003eModels\u003c/a\u003e.\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"math/forces.md\"\u003eForces\u003c/a\u003e.\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"math/waves.md\"\u003eWaves\u003c/a\u003e (periodic processes).\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"math/signal-processing.md\"\u003eSignal Processing\u003c/a\u003e (sinoids).\u003c/li\u003e\n\u003c/ul\u003e\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003ePractice: \u003cb\u003eSoftware Industry\u003c/b\u003e\u003c/summary\u003e\n\u003cul style=\"margin: 1em;\"\u003e\n\u003cli\u003e\u003ca href=\"software-industry/security.md\"\u003eSecurity\u003c/a\u003e.\u003c/li\u003e\n\u003cli\u003eSoftware \u003ca href=\"software-industry/software-engineering.md\"\u003eEngineering\u003c/a\u003e.\u003c/li\u003e\n\u003cli\u003eSoftware \u003ca href=\"software-industry/software-domains.md\"\u003eDomains\u003c/a\u003e.\u003c/li\u003e\n\u003cli\u003eSoftware \u003ca href=\"software-industry/software-development-cycle.md\"\u003eDevelopment Cycle\u003c/a\u003e.\u003c/li\u003e\n\u003c/ul\u003e\n\u003c/details\u003e\nSocial\n\n\u003cdetails\u003e\n\u003csummary\u003eTheory: \u003cb\u003eIntelligence\u003c/b\u003e (and reasoning)\u003c/summary\u003e\n\u003cul style=\"margin: 1em;\"\u003e\n\u003cli\u003e\u003ca href=\"intelligence/knowledge.md\"\u003eKnowledge\u003c/a\u003e (and truth).\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"intelligence/creativity.md\"\u003eCreativity\u003c/a\u003e (exercises for brainstorming).\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"intelligence/learning.md\"\u003eLearning\u003c/a\u003e (change and improvement).\u003c/li\u003e\n\u003cli\u003e\u003ca href=\"intelligence/modelling.md\"\u003eModels\u003c/a\u003e and modelling principles.\u003c/li\u003e\n\u003c/ul\u003e\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003ePractice: \u003cb\u003eCollaboration\u003c/b\u003e (and communication)\u003c/summary\u003e\n\u003cul style=\"margin: 1em;\"\u003e\n\u003cli\u003eCommunication\u003c/li\u003e\n\u003cul style=\"margin: 0;\"\u003e\n  \u003cli\u003e\u003ca href=\"communication/principles.md\"\u003eCommunication principles\u003c/a\u003e (human communication).\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"collaboration/messaging.md\"\u003eMessaging\u003c/a\u003e (verbally or non-verbally).\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"collaboration/interview-questions.md\"\u003eInterview Questions\u003c/a\u003e (discovery).\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"collaboration/retrospectives.md\"\u003eRetrospective\u003c/a\u003e exercises for reflection for groups.\u003c/li\u003e\n\u003c/ul\u003e\n\u003cli\u003eCreating value\u003c/li\u003e\n\u003cul style=\"margin: 0;\"\u003e\n  \u003cli\u003e\u003ca href=\"labour/labour.md\"\u003eLabour\u003c/a\u003e (work and management of work).\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"systems/system.md\"\u003eOrganization\u003c/a\u003e (identity)\u003c/li\u003e\n  \u003cli\u003e\u003ca href=\"systems/teams.md\"\u003eTeams\u003c/a\u003e (structure and effectiveness)\u003c/li\u003e\n\u003c/ul\u003e\n\u003c/ul\u003e\n\u003c/details\u003e\n\nOther\n\n- [Quotes](quotes.md) - to contemplate (high level).\n- [Behaviour](behaviour.md) - *generic* ideas, *specific* to human behaviour.\n- [Documentation](documentation.md).\n\n## Other\n\n**Templates and exercises**\n\n- Interactive\n  - [Retrospective](collaboration/retrospectives.md) exercises.\n  - [Brainstorming](intelligence/creativity.md#Prompts) prompts.\n  - [Interview questions](collaboration/interview-questions.md).\n\n- Documentation\n  - [Documentation](documentation.md#Templates) templates.\n  - [Requirements engineering](organization/requirements.md).\n\n**Relations between documents**\n\nFrom abstract theory to application within a domain. For a full overview, see [this table](software-industry/software-domains-table.md).\n\n- [Communication Patterns](systems/communication-patterns.md) \u003e [Programming Patterns](domain-modelling/programming-patterns.md) \u003e [Programming Paradigms](computer-languages/programming-paradigms.md)\n- [Requirements Engineering](organization/requirements.md) \u003e [Project Management](management/project-management.md)\n- [Systems Management](systems/systems-management.md) \u003e [Organization Structure](systems/structure.md) \u003e [Organization Architecture](organization-architecture.md)\n- [Management Principles](management/management-principles.md) \u003e (management of)  [Systems](systems/systems-management.md) \u003e a [Product](management/product-management.md) \u003e a [Platform](organization/platform) \u003e a [Project](management/project-management.md)\n\nThemes\n\n- Quality, flow \u0026 systems: [domains](reality/structure.md), [organization](systems/system.md), [emotions](psychology/emotions.md).\n- Agile coaching. [coaching](communication/coaching.md), [Scrum](collaboration/scrum-guide), [coaching](communication/coaching.md), [activity](subject/activity.md), [organization](systems/system.md), [systems](systems/systems-management.md).\n\n**Perspective \u0026 Generalizability of Guidelines**\n\n[Source](https://twitter.com/johncutlefish/status/1406534814673477633)\n\n1. **Generic** but subjective.\n    - Theory, Principle, doctrine, culture.\n    - Implicit, feeling, *can be sensed*.\n    - Difficult to prove or falsify.\n    - Applicable always and anywhere.\n2. Objective but **specific**.\n    - Practice, habit, skill.\n    - Explicit, Concrete, *measurable*, *actionable*.\n    - Provable, falsifiable.\n    - Applicable to a single moment or location.\n\nE.g. a goal can be short-term and precise, or long-term but vague.\n\nDefinition of *anti-pattern*: a commonly used, bad solution to a problem. Possibly just an indicator, signaling a deeper issue.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoschezang%2Fcoding-handbook","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvoschezang%2Fcoding-handbook","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvoschezang%2Fcoding-handbook/lists"}