DecisionCapture

KO | EN

gitlite — search

#python #typescript #llm #golang #rust #linux #macos #windows #awesome #kubernetes #awesome-list #vue #security #ios

DecisionCapture

(★ 21)

This repository is used to publish and share templates and guides on capturing decisions in agile software development. It is part of our research on rationale management in agile software development.

DecisionCapture Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Making Decisions Sustainable in Agile Software Development -- A Research Study

* [Introduction](#introduction)
* [Study Goals](#studyGoals)
* [Study Setup](#studySetup)
* [Example templates](#decision-templates)
* [How to start capturing decision](#how-to-start-capturing)
* [How to start capturing decision with tools](#how-to-start-capturing-with-tools)
* [How to start capturing decision with git](#how-to-start-capturing-decisions-with-git)
* [Contributing](#contributing)
* [Sources](#sources)

<h2><a name="introduction">Introduction</a></h2>

This repository is used to publish and share templates and guidelines on capturing and using decision in agile software development. It is part of our research on decision management in agile software development. Unlike the approach of [joelparkerhenderson](https://github.com/joelparkerhenderson/architecture_decision_record/), we do not only focus on [architectural decisions](https://github.com/joelparkerhenderson/architecture_decision_record/#introduction) but on decisions being important to the development team. Thus, we consider every development related decision to be potentially important. Nevertheless, these are often architectural decisions.

According to the agile principle 'The best architectures, requirements, and designs emerge from self-organizing teams' we assume that the team does know best what is an important decision and what is not. Thus, we only provide an examplary list of decisions types from previous studies with industry partners and students ([see section](#decisions)). Nevertheless, we also encourage you to read [joelparkerhenderson's elaboration](https://github.com/joelparkerhenderson/architecture_decision_record/#introduction) on architectural decisions, if you are interested in the topic of managing decision. More literature on the topic of architectural knowledge management can be found [further down](#sources).

The goal of this document is to provide a quick overview of methods and templates of capturing decisions in agile software development, how to create them, and where to look for more information.

<h2><a name="decisions">What decision are we talking about?</a></h2>

As outlined above, we have no intention of telling someone what kind of decisions he/she should consider being particularly important. Thus, decisions to capture by the team can be of any type. In order to give you some help anyway, we have put together an exemplary list of decisions as follows:

* Decisions regarding development tools – e.g., employed IDE, project management tools.
* Architectural decisions – e.g., interfaces definitions, architectural decisions. 
* Technology decisions – e.g., employed libraries and frameworks and its pros and cons.
* Decisions on the deployment plattform – e.g., deployment process, Android vs. iOS.
* Decisions on features – e.g., add / refine / change / remove a requirement.
* Decisions on priorising User Stories – e.g., postpone, prepone or omit a user story.
* Decisions on software quality measures – e.g., schedule a refactoring, a review or similar.
* Decisions regarding the user experience – e.g., revise the strategy for the user experience.
* Decisions regarding the team prganisation – e.g., changes of roles, staff reshuffling, or similar.
* Decisions on software development process – e.g., restructure the sprint based on the outcome of the retrospective

The list has been deduced on the basis of existing literature as well as student and industry studies we conducted. Precisely because there were decisions that we could not classify, the list does not claim to be complete. Nevertheless, the absolute majority of decisions recorded in our studies are represented by the above list.

<h2><a name="decision-templates">Decision capture example templates</a></h2>

In the following listing you can find links to three templates for capturing decisions. We currently use them for experiments with students and industry practitioners.

* [Simple template](templates/captureTemplate_simple.md) (Provides ...)
* [Extensive template](templates/captureTemplate_full.md) (Provides ...)
* [Table-based template](templates/captureTemplate_table.md) (Provides ...)

<h2><a name="how-to-start-capturing">How to start capturing decisions?</a></h2>

TODO

<h2><a name="how-to-start-capturing-with-tools">How to start capturing decisions with tools</a></h2>

TODO

<h2><a name="how-to-start-capturing-decisions-with-git">How to start capturing decisions with git?</a></h2>

TODO

<h2><a name="contributing">Contributing</a></h2>

Your comments and suggestions are welcome.

You can open a GitHub issue, or create a pull request, or email M.Schubanz@b-tu.de.

<h2><a name="sources">Sources</a></h2>

Other templates:

* [Documenting architecture decisions - Michael Nygard](http://thinkrelevance.com/blog/2011/11/15/documenting-architecture-decisions)
* [Template for documenting architecture alternatives and decisions - Stack Overflow](http://stackoverflow.com/questions/7104735/template-for-documenting-architecture-alternatives-and-decisions)

In-depth:

* [ADMentor XML project - GitHub](https://github.com/IFS-HSR/ADMentor)
* [Architectural Decision Guidance across Projects: Problem Space Modeling, Decision Backlog Management and Cloud Computing Knowledge](https://www.ifs.hsr.ch/fileadmin/user_upload/customers/ifs.hsr.ch/Home/projekte/ADMentor-WICSA2015ubmissionv11nc.pdf)
* [The Decision View's Role in Software Architecture Practice](https://www.computer.org/csdl/mags/so/2009/02/mso2009020036-abs.html)
* [Documenting Software Architectures: Views and Beyond](http://resources.sei.cmu.edu/library/asset-view.cfm?assetID=30386)
* [Architecture Decisions: Demystifying Architecture](https://www.utdallas.edu/~chung/SA/zz-Impreso-architecture_decisions-tyree-05.pdf)
* [ThoughtWorks Technology Radar: Lightweight Architecture Decision Records](https://www.thoughtworks.com/radar/techniques/lightweight-architecture-decision-records)

DecisionCapture

DecisionCapture Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

DecisionCapture

DecisionCapture Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README