Skip to content

Commit 6e0f191

Browse files
Add teamwork questions for ADRs
1 parent 2c06897 commit 6e0f191

File tree

7 files changed

+272
-110
lines changed

7 files changed

+272
-110
lines changed

README.md

Lines changed: 169 additions & 110 deletions
Large diffs are not rendered by default.
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
60057747e4547af35fd888021e41f332
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
index.md
Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
## Cwestiynau gwaith tîm ar gyfer ADRau
2+
3+
### Pwy all greu ADR?
4+
5+
Ystyriwch feysydd fel pobl benodol, neu rolau penodol, neu dimau penodol, neu adrannau penodol; ystyriwch hefyd a oes pobl, neu rolau, neu dimau, neu adran a all gomisiynu ADR, sy'n golygu eu bod yn gofyn am un y bydd rhywun arall yn ei awduro.
6+
7+
Ateb enghreifftiol: Gall unrhyw berson yn ein sefydliad sydd wedi darllen tudalen README cofnod penderfyniad pensaernïaeth gynnig ADR, sy'n golygu y gall y person ddechrau ei ysgrifennu, a'i rannu gyda'r tîm.
8+
9+
### Beth sy'n cyfiawnhau codi ADR?
10+
11+
Ystyriwch feysydd fel ffyrdd gweithio tîm eich sefydliad, strwythur eich system feddalwedd, cydlynu traws-dîm, cynaladwyedd hirdymor, rhyngwynebau allanol, pwy rydych chi am iddo fod o fudd, a'r cyffelyb.
12+
13+
Ateb enghreifftiol: Rydym am greu ADR pan fyddwn am i ddatblygwyr y dyfodol ddeall y "pam" dros yr hyn rydym yn ei wneud.
14+
15+
### Beth sy'n cyfiawnhau peidio â chodi ADR?
16+
17+
Ystyriwch feysydd fel penderfyniadau nad ydynt yn ymwneud â phensaernïaeth, neu sy'n fach fel risg leiaf neu hunangynhwysol neu ddatblygwr sengl, neu sydd eisoes wedi'u cynnwys yn llawn mewn mannau eraill fel gan safonau neu bolisïau neu ddogfennaeth, neu sy'n dros dro fel atebion dros dro neu brofion o gysyniadau neu arbrofion.
18+
19+
Ateb enghreifftiol: Rydym am hepgor ADR pan fo penderfyniad yn gyfyngedig o ran cwmpas ac amser a risg a chost, neu pan fydd eisoes wedi'i gynnwys mewn mannau eraill.
20+
21+
### Beth yw cylch bywyd ADR?
22+
23+
Ystyriwch feysydd fel y broses greu, y broses ymchwil, y broses benderfynu, y broses weithredu, a'r broses machlud. Ystyriwch sut i olrhain cylch bywyd yr ADR dros amser, fel sut i symud yr ADR o un cyflwr i'r cyflwr nesaf, a hefyd sut i gyfleu hyn i randdeiliaid.
24+
25+
Ateb enghreifftiol: Rydym am i ADR gael cam cylch bywyd: Cychwyn → Ymchwilio → Gwerthuso → Gweithredu → Cynnal → Machlud.
26+
27+
### Beth yw'r meini prawf ar gyfer camau cylch bywyd ADR?
28+
29+
Ystyriwch feysydd fel meini prawf derbyn ar gyfer ADR, sy'n golygu sut ydych chi'n gwybod ei fod yn ddigon da i symud ymlaen o un cam cylch bywyd i'r nesaf? A yw'r broblem wedi'i mynegi'n glir? A yw'r dewisiadau amgen wedi'u hystyried? A yw cyfaddawdau wedi'u deall a'u dogfennu'n ddigon da?
30+
A yw'r holl gyd-destun perthnasol ar waith? A yw'r holl randdeiliaid perthnasol wedi'u cynnwys? A yw'r holl adborth wedi'i ymgorffori?
31+
32+
Ateb enghreifftiol: Rydym am i randdeiliaid bleidleisio ar ADR pan fydd y tîm gweithredol wedi 1) cwblhau eu hymchwil, 2) cwblhau eu gwerthusiad, 3) cyhoeddi'r cynnig ADR i'r rhanddeiliaid gyda chais am sylwadau ac amserlen o un wythnos, 4) bod yr holl sylwadau gan randdeiliaid wedi'u hymgorffori a'u trin.
33+
34+
### Pa rolau a chyfrifoldebau sy'n rhyngweithio ag ADR?
35+
36+
Ystyriwch rolau fel cynigydd, ymchwilydd, gwerthuswr, adolygydd, cymeradwywr, cynhaliwr, a'r fel. Ystyriwch gyfrifoldebau fel cyfathrebu â rhanddeiliaid, sicrhau bod disgwyliadau'n cael eu bodloni, rhannu ar y wefan neu'r fewnrwyd, ac adolygu'r gwaith yn rheolaidd ac yn enwedig pan fydd newidiadau perthnasol yn digwydd.
37+
38+
Ateb enghreifftiol: Rydym am i bob ADR gael prif berson cyswllt, ail berson cyswllt, a thîm atebol bob amser; mae'r rhain yn gyfrifol am gyfathrebu, cyhoeddiadau, cynnal a chadw, adolygiad cyfnodol o leiaf unwaith y flwyddyn, a'i machlud yn y pen draw yn ôl yr angen.
39+
40+
### Sut mae llywodraethu'n rhyngweithio ag ADR?
41+
42+
Ystyriwch feysydd fel ffyrdd gweithio eich sefydliad, unrhyw anghenion cydymffurfio arbennig fel ar gyfer agweddau cyfreithiol neu agweddau adnoddau dynol, sut rydych chi am ymdrin â chonsensws yn erbyn gwrthdaro yn erbyn dwysáu. A oes meysydd neu bobl neu dimau a all gael mwy o ddylanwad nag eraill ynghylch ADR, fel gallu ei gymeradwyo, neu bleidleisio arno, neu ei feto?
43+
44+
Ateb enghreifftiol: Mae llywodraethu ADR yn y drefn flaenoriaeth hon: y Prif Swyddog Gweithredol, y Prif Swyddog Technoleg, y Prif Swyddog Cyswllt, y tîm sy'n gweithredu ADR, yr arbenigwyr yn y tîm sydd fwyaf gwybodus am yr ADD. Nid oes gan unrhyw un arall lywodraethu oni bai ei fod wedi'i ddisgrifio yn y ADR.
45+
46+
### Pa egwyddorion sy'n rhyngweithio ag ADR?
47+
48+
Ystyriwch feysydd fel ffyrdd gweithio eich sefydliad sy'n cynnwys symud yn gyflym yn erbyn symud yn araf, ar gyfer consensws penderfyniadau yn erbyn gwrthdaro penderfyniadau, ac ar gyfer dewisiadau risg yn erbyn dewisiadau diogelwch, trafodaeth gyhoeddus yn erbyn trafodaeth breifat, a'r cyffelyb.
49+
50+
Ateb enghreifftiol: Rydym yn defnyddio egwyddorion arweinyddiaeth rhagfarn ar gyfer gweithredu, anghytuno ac ymrwymo, mae amcangyfrifon o 70% yn ddigon da ar gyfer penderfyniadau y gellir eu gwrthdroi'n hawdd ac y gellir eu hynysu'n hawdd, a ffyrdd cyhoeddus o weithio ac eithrio gwybodaeth gyfrinachol fel y disgrifir yng nghytundeb cyfrinachedd ein sefydliad.
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
60057747e4547af35fd888021e41f332
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
index.md
Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
2+
### Who can create an ADR?
3+
4+
Consider areas such as specific people, or specific roles, or specific teams, or specific departments; also consider if there are people, or roles, or teams, or department that can commission an ADR, meaning they request one that someone else will author.
5+
6+
Example answer: Any person in our organization who has read the architecture decision record README page can propose an ADR, meaning the person can start writing it, and share it with the team.
7+
8+
### What justifies raising an ADR?
9+
10+
Consider areas such as your organization's team ways of working, your software system structure, cross-team coordination, long-term maintainability, external interfaces, who you want to benefit, and the like.
11+
12+
Example answer: We want to create an ADR when we want future developers to understand the “why” of what we're doing.
13+
14+
### What justifies not rasing an ADR?
15+
16+
Consider areas such as decisions that are not about architecture, or are tiny such as minimal-risk or self-contained or single-developer, or are already fully covered elsewhere such as by standards or policies or documentation, or are temporary such as workarounds or proofs of concepts or orexperiments.
17+
18+
Example answer: We want to skip an ADR when a decision is limited in scope and time and risk and cost, or is already covered elsewhere.
19+
20+
### What is the lifecycle of an ADR?
21+
22+
Consider areas such as the creation process, research process, decisioning process, implementation process, and sunsetting process. Consider how to track the ADR lifecycle over time, such as how to move the ADR from one state to the next state, and also how to communicate this to stakeholders.
23+
24+
Example answer: We want an ADR to have five lifecycle stages: Initiating → Researching → Evaluating → Implementing → Maintaining → Sunsetting.
25+
26+
### What are criteria for lifecycle steps of an ADR?
27+
28+
Consider areas such as acceptance criteria for an ADR, meaning how do you know it's good enough to progress from one lifecycle step to the next? Is the problem clearly articulated? Have the alternatives been considered? Are trade-offs well-enough understood and documented?
29+
Is all relevant context in place? Are all revelant stakeholders involved? Has all feedback been incorporated?
30+
31+
Example answer: We want an ADR to be voted on by stakeholders when the active team has 1) completed their research, 2) completed their evaluation, 3) published the ADR proposal to the stakeholders with a request for comments and a timebox of one week, 4) all stakeholder comments have been incorporated and addressed.
32+
33+
### What roles and responsibilities interact with an ADR?
34+
35+
Consider roles such as proposer, researcher, evaluator, reviewer, approver, maintainer, and the like. Consider responsbilities such as communication with stakeholders, ensuring expectations are met, sharing on the website or intranet, and reviewing the work periodically and especially when relevant changes happen.
36+
37+
Example answer: We want each ADR to always have a primary contact person, secondary contact person, and accountable team; these are responsble for communications, publications, maintenance, periodic review at least once per year, and eventual sunsetting as needed.
38+
39+
### How does governance interact with an ADR?
40+
41+
Consider areas such as your organization's ways of working, any special compliance needs such as for legal aspects or human resource aspects, how you want to handle consensus versus conflict versus escalation. Are there areas or people or teams that can have more influence than others regarding an ADR, such as being able to approve it, or vote on it, or veto it?
42+
43+
Example answer: The governance of an ADR is in this priority order: the CEO, the CTO, the CLO, the team that implements an ADR, the experts on the team that are most-knowledgeable about the ADD. No one else has governance unless described in the ADR.
44+
45+
### What principles interact with an ADR?
46+
47+
Consider areas such as your organization's ways of working that include moving quickly versus moving slowly, for decision consensus versus decision conflict, and for risk preferences versus safety preferences, public discussion versus private discussion, and the like.
48+
49+
Example answer: We use the leadership priciples of bias for action, disagree-and-commit, 70% estimates are good enough for easily-reversable easily-isolatable decisions, and public ways of working with the exception of confidential information as described in our organization's confidentiality agreement.

0 commit comments

Comments
 (0)