From 32569115de7e70154b200ddf8a2734743a2bb8d1 Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Sat, 23 Mar 2024 14:20:56 +0100 Subject: [PATCH 1/4] Add link to repo jakobo/rfc, joining a guide for how to set up a company-internal RFC process. --- .../transparent-cross-team-decision-making-using-rfcs.md | 1 + 1 file changed, 1 insertion(+) diff --git a/patterns/2-structured/transparent-cross-team-decision-making-using-rfcs.md b/patterns/2-structured/transparent-cross-team-decision-making-using-rfcs.md index f21de9753..b1c5bdf84 100644 --- a/patterns/2-structured/transparent-cross-team-decision-making-using-rfcs.md +++ b/patterns/2-structured/transparent-cross-team-decision-making-using-rfcs.md @@ -61,6 +61,7 @@ Important elements of the solution are: - [Rust][rust] is a good Open Source example of RFC template and process, and has been the basis for many other RFC processes. - [Generalized BBC iPlayer & Sounds RFC template](templates/rfc.md), originally based on the [Rust][rust] template +- [jakobo/rfc][https://github.com/jakobo/rfc] outlines how to set up a company-internal RFC process. It contains a [detailed explanation](https://github.com/jakobo/rfc/blob/master/text/0001-using_rfcs.md) of why RFCs are important and an [RFC template](https://github.com/jakobo/rfc/blob/master/0000-template.md) to help you write your first RFC. It contains contains information such as motivation/rational, guide implementation, a reference implementation, drawbacks, as well as alternatives to the RFC approach. Bonus: The description itself is an RFC, so while reading it you are already getting a sense of how an RFC works. ## Resulting Context From dbe250a6fe5d9724bc4cdd054f0d01f6633c5b60 Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Sat, 23 Mar 2024 14:22:38 +0100 Subject: [PATCH 2/4] Clarifying which 'Requests for Comments' we are referring to here --- .../transparent-cross-team-decision-making-using-rfcs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/patterns/2-structured/transparent-cross-team-decision-making-using-rfcs.md b/patterns/2-structured/transparent-cross-team-decision-making-using-rfcs.md index b1c5bdf84..3de087211 100644 --- a/patterns/2-structured/transparent-cross-team-decision-making-using-rfcs.md +++ b/patterns/2-structured/transparent-cross-team-decision-making-using-rfcs.md @@ -41,7 +41,7 @@ Like with any process, this must be continually improved upon. There may need to ## Solutions -We chose an RFC-like process for increasing the transparency of our cross-team decision making process (also see [Requests for Comments][requests-for-comments]). +We chose an RFC-like process for increasing the transparency of our cross-team decision making process (also see IETF's [Requests for Comments][requests-for-comments]). Important elements of the solution are: From 9da175f675bc4eea2ec3a21aacc551207cc76c33 Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Sat, 23 Mar 2024 15:36:22 +0100 Subject: [PATCH 3/4] Fix link syntax --- .../transparent-cross-team-decision-making-using-rfcs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/patterns/2-structured/transparent-cross-team-decision-making-using-rfcs.md b/patterns/2-structured/transparent-cross-team-decision-making-using-rfcs.md index 3de087211..05478626f 100644 --- a/patterns/2-structured/transparent-cross-team-decision-making-using-rfcs.md +++ b/patterns/2-structured/transparent-cross-team-decision-making-using-rfcs.md @@ -61,7 +61,7 @@ Important elements of the solution are: - [Rust][rust] is a good Open Source example of RFC template and process, and has been the basis for many other RFC processes. - [Generalized BBC iPlayer & Sounds RFC template](templates/rfc.md), originally based on the [Rust][rust] template -- [jakobo/rfc][https://github.com/jakobo/rfc] outlines how to set up a company-internal RFC process. It contains a [detailed explanation](https://github.com/jakobo/rfc/blob/master/text/0001-using_rfcs.md) of why RFCs are important and an [RFC template](https://github.com/jakobo/rfc/blob/master/0000-template.md) to help you write your first RFC. It contains contains information such as motivation/rational, guide implementation, a reference implementation, drawbacks, as well as alternatives to the RFC approach. Bonus: The description itself is an RFC, so while reading it you are already getting a sense of how an RFC works. +- [jakobo/rfc](https://github.com/jakobo/rfc) outlines how to set up a company-internal RFC process. It contains a [detailed explanation](https://github.com/jakobo/rfc/blob/master/text/0001-using_rfcs.md) of why RFCs are important and an [RFC template](https://github.com/jakobo/rfc/blob/master/0000-template.md) to help you write your first RFC. It contains contains information such as motivation/rational, guide implementation, a reference implementation, drawbacks, as well as alternatives to the RFC approach. Bonus: The description itself is an RFC, so while reading it you are already getting a sense of how an RFC works. ## Resulting Context From ee2207e96565a55c1c9bd7659253ee835a272511 Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Mon, 8 Apr 2024 17:28:53 +0200 Subject: [PATCH 4/4] Remove duplicate word --- .../transparent-cross-team-decision-making-using-rfcs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/patterns/2-structured/transparent-cross-team-decision-making-using-rfcs.md b/patterns/2-structured/transparent-cross-team-decision-making-using-rfcs.md index 05478626f..5c46178a9 100644 --- a/patterns/2-structured/transparent-cross-team-decision-making-using-rfcs.md +++ b/patterns/2-structured/transparent-cross-team-decision-making-using-rfcs.md @@ -61,7 +61,7 @@ Important elements of the solution are: - [Rust][rust] is a good Open Source example of RFC template and process, and has been the basis for many other RFC processes. - [Generalized BBC iPlayer & Sounds RFC template](templates/rfc.md), originally based on the [Rust][rust] template -- [jakobo/rfc](https://github.com/jakobo/rfc) outlines how to set up a company-internal RFC process. It contains a [detailed explanation](https://github.com/jakobo/rfc/blob/master/text/0001-using_rfcs.md) of why RFCs are important and an [RFC template](https://github.com/jakobo/rfc/blob/master/0000-template.md) to help you write your first RFC. It contains contains information such as motivation/rational, guide implementation, a reference implementation, drawbacks, as well as alternatives to the RFC approach. Bonus: The description itself is an RFC, so while reading it you are already getting a sense of how an RFC works. +- [jakobo/rfc](https://github.com/jakobo/rfc) outlines how to set up a company-internal RFC process. It contains a [detailed explanation](https://github.com/jakobo/rfc/blob/master/text/0001-using_rfcs.md) of why RFCs are important and an [RFC template](https://github.com/jakobo/rfc/blob/master/0000-template.md) to help you write your first RFC. It contains information such as motivation/rational, guide implementation, a reference implementation, drawbacks, as well as alternatives to the RFC approach. Bonus: The description itself is an RFC, so while reading it you are already getting a sense of how an RFC works. ## Resulting Context