From e68a73df03888a218421007d5d872f8420207c66 Mon Sep 17 00:00:00 2001 From: Niels Braczek Date: Wed, 24 Aug 2022 23:46:11 +0200 Subject: [PATCH 1/7] Summary and Why Bother --- proposed/decoupling-output-meta.md | 65 ++++++++++++++++++++++++++++++ proposed/decoupling-output.md | 45 +++++++++++++++++++++ 2 files changed, 110 insertions(+) create mode 100644 proposed/decoupling-output-meta.md create mode 100644 proposed/decoupling-output.md diff --git a/proposed/decoupling-output-meta.md b/proposed/decoupling-output-meta.md new file mode 100644 index 0000000..319662e --- /dev/null +++ b/proposed/decoupling-output-meta.md @@ -0,0 +1,65 @@ +# Decoupling Output Meta Document + +## 1. Summary + +_The separation of the visual preparation and presentation of the content from its management is what we call +decoupling of the output._ + +The aim of this specification is to decouple the output layer from the core of the CMS so that necessary changes to the +CMS code require as few changes as possible to the templates and their overrides. + +## 2. Why Bother? + +Every major version so far has stirred up resentment among users because not only programme code but also templates, +layouts and overrides had to be revised. If we succeed in reducing the points of contact between the CMS core and the +actual views to interfaces, not only will the adaptation effort for templates, layouts and overrides be considerably +less, it will even be possible to offer output layers with completely different frontend libraries than before. + +## 3. Scope + +### 3.1 Goals + +### 3.2 Non-Goals + +## 4. Approaches + +### 4.1 Approach 1 + +#### 4.1.1 Projects Using Approach 1 + +### 4.2 Approach 2 + +#### 4.2.1 Projects Using Approach 2 + +### 4.3 Comparison of Approaches + +### 4.4 Chosen Approach + +## 5. Design Decisions + +## 6. People + +### 6.1 Editor(s) + +* Niels Braczek + +### 6.2 Sponsors + +* N/A + +### 6.3 Contributors + +* N/A + +## 7. Votes + +* **Entrance Vote:** _(not yet taken)_ +* **Acceptance Vote:** _(not yet taken)_ + +## 8. Relevant Links + +_**Note:** Order descending chronologically._ + +## 9. Errata + +... diff --git a/proposed/decoupling-output.md b/proposed/decoupling-output.md new file mode 100644 index 0000000..ca4f072 --- /dev/null +++ b/proposed/decoupling-output.md @@ -0,0 +1,45 @@ +# Decoupling Output + +This document describes ... + +The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", +"SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be +interpreted as described in [RFC 2119][]. + +[RFC 2119]: http://tools.ietf.org/html/rfc2119 + +### References + +- [RFC 2119][]: Key words for use in RFCs to Indicate Requirement Levels + +## 1. Specification + +### 1.1 Spec A + +### 1.2 Spec B + +## 2. Interfaces + +### 2.1 Interface A + +The following interface MUST be implemented by compatible ... + +```php +namespace ...; + +interface ... +{ +} +``` + +### 2.2 Inteface B + +The following interface MUST be implemented by compatible ... + +```php +namespace ...; + +interface ... +{ +} +``` From 79b7c14d43b6cbde31774e51bc286dcf660f3c14 Mon Sep 17 00:00:00 2001 From: Niels Braczek Date: Mon, 19 Dec 2022 23:14:29 +0100 Subject: [PATCH 2/7] Update after motions in Dec 2022 --- index.md | 43 +++++++++++++++++++++++++++++-------------- 1 file changed, 29 insertions(+), 14 deletions(-) diff --git a/index.md b/index.md index 9083c0e..2ea37c7 100644 --- a/index.md +++ b/index.md @@ -27,9 +27,11 @@ The sponsor is responsible for managing the review stage and votes. ### Draft -| Num | Title | Editor | Sponsor | -|:---:|--------------------------------|-------------------------|-------------------| -| N/A | N/A | N/A | N/A | +| Num | Title | Editor | Sponsor | +|:---:|-----------------------------------------|-----------------------------------------------------|------------------------------------------------------------------------| +| 1 | [Decpoupling Output](decoupling-output) | Niels Braczek | Llewellyn van der Merwe | +| 2 | [Form Admin](form-admin) | Niels Braczek | Llewellyn van der Merwe | +| 3 | [Simple CCK](simple-cck) | Niels Braczek | Llewellyn van der Merwe | ### Pre-Draft @@ -51,20 +53,33 @@ The sponsor is responsible for managing the review stage and votes. |:---:|--------------------------------|-------------------------|-------------------| | N/A | N/A | N/A | N/A | +### Rejected + +| Title | Editor | Sponsor | +|-----------------------------|-------------------------|-------------------| +| [Append Form](append-form) | Niels Braczek | Llewellyn van der Merwe | + ## Numerical Index -| Status | Num | Title | Editor | Sponsor | -|--------|:---:|--------------------------------|-------------------------|-------------------| -| A | 0 | [RFC Procedure][rfc-procedure] | Niels Braczek | Marco Dings | +| Status | Num | Title | Editor | Sponsor | +|--------|:---:|-----------------------------------------|----------------------------------------------------|-------------------| +| A | 0 | [RFC Procedure][rfc-procedure] | Niels Braczek | Marco Dings | +| D | 1 | [Decpoupling Output](decoupling-output) | Niels Braczek | Llewellyn van der Merwe | +| D | 2 | [Form Admin](form-admin) | Niels Braczek | Llewellyn van der Merwe | +| D | 3 | [Simple CCK](simple-cck) | Niels Braczek | Llewellyn van der Merwe | _**Legend:** A = Accepted | D = Draft | P = Pre-Draft | R = Review | X = Deprecated_ [workflow]: bylaws/workflow.md -[contentelements]: https://github.com/joomla-x/joomla-Specifications/tree/master/proposed -[authorisation]: https://github.com/joomla-x/joomla-standards/pull/2 -[joomla-cli]: https://github.com/joomla-x/joomla-standards/pull/4 -[mobile-app]: https://github.com/joomla-x/joomla-standards/pull/5 -[simplify-admin]: https://github.com/joomla-x/joomla-standards/pull/6 -[simplify-admin2]: https://github.com/joomla-x/joomla-standards/pull/7 -[composer]: https://github.com/joomla-x/joomla-standards/pull/8 -[rfc-procedure]: https://github.com/joomla-x/joomla-standards/blob/master/accepted/RFC-0-rfc-meta.md +[contentelements]: https://github.com/joomla/rfc/tree/master/proposed +[authorisation]: https://github.com/joomla/rfc/pull/2 +[joomla-cli]: https://github.com/joomla/rfc/pull/4 +[mobile-app]: https://github.com/joomla/rfc/pull/5 +[simplify-admin]: https://github.com/joomla/rfc/pull/6 +[simplify-admin2]: https://github.com/joomla/rfc/pull/7 +[composer]: https://github.com/joomla/rfc/pull/8 +[rfc-procedure]: https://github.com/joomla/rfc/blob/master/accepted/RFC-0-rfc-meta.md +[decoupling-output]: https://github.com/joomla/rfc/pull/36 +[form-admin]: https://github.com/joomla/rfc/pull/31 +[simple-cck]: https://github.com/joomla/rfc/pull/26 +[append-form]: https://github.com/joomla/rfc/pull/18 From b3ad7ff93d837b1a7007bc6cac36f772fae70bdd Mon Sep 17 00:00:00 2001 From: Niels Braczek Date: Wed, 24 Aug 2022 23:46:11 +0200 Subject: [PATCH 3/7] Summary and Why Bother --- proposed/decoupling-output-meta.md | 65 ++++++++++++++++++++++++++++++ proposed/decoupling-output.md | 45 +++++++++++++++++++++ 2 files changed, 110 insertions(+) create mode 100644 proposed/decoupling-output-meta.md create mode 100644 proposed/decoupling-output.md diff --git a/proposed/decoupling-output-meta.md b/proposed/decoupling-output-meta.md new file mode 100644 index 0000000..319662e --- /dev/null +++ b/proposed/decoupling-output-meta.md @@ -0,0 +1,65 @@ +# Decoupling Output Meta Document + +## 1. Summary + +_The separation of the visual preparation and presentation of the content from its management is what we call +decoupling of the output._ + +The aim of this specification is to decouple the output layer from the core of the CMS so that necessary changes to the +CMS code require as few changes as possible to the templates and their overrides. + +## 2. Why Bother? + +Every major version so far has stirred up resentment among users because not only programme code but also templates, +layouts and overrides had to be revised. If we succeed in reducing the points of contact between the CMS core and the +actual views to interfaces, not only will the adaptation effort for templates, layouts and overrides be considerably +less, it will even be possible to offer output layers with completely different frontend libraries than before. + +## 3. Scope + +### 3.1 Goals + +### 3.2 Non-Goals + +## 4. Approaches + +### 4.1 Approach 1 + +#### 4.1.1 Projects Using Approach 1 + +### 4.2 Approach 2 + +#### 4.2.1 Projects Using Approach 2 + +### 4.3 Comparison of Approaches + +### 4.4 Chosen Approach + +## 5. Design Decisions + +## 6. People + +### 6.1 Editor(s) + +* Niels Braczek + +### 6.2 Sponsors + +* N/A + +### 6.3 Contributors + +* N/A + +## 7. Votes + +* **Entrance Vote:** _(not yet taken)_ +* **Acceptance Vote:** _(not yet taken)_ + +## 8. Relevant Links + +_**Note:** Order descending chronologically._ + +## 9. Errata + +... diff --git a/proposed/decoupling-output.md b/proposed/decoupling-output.md new file mode 100644 index 0000000..ca4f072 --- /dev/null +++ b/proposed/decoupling-output.md @@ -0,0 +1,45 @@ +# Decoupling Output + +This document describes ... + +The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", +"SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be +interpreted as described in [RFC 2119][]. + +[RFC 2119]: http://tools.ietf.org/html/rfc2119 + +### References + +- [RFC 2119][]: Key words for use in RFCs to Indicate Requirement Levels + +## 1. Specification + +### 1.1 Spec A + +### 1.2 Spec B + +## 2. Interfaces + +### 2.1 Interface A + +The following interface MUST be implemented by compatible ... + +```php +namespace ...; + +interface ... +{ +} +``` + +### 2.2 Inteface B + +The following interface MUST be implemented by compatible ... + +```php +namespace ...; + +interface ... +{ +} +``` From 3636d25f2d90cf38c0fca3360bef2623beca0e13 Mon Sep 17 00:00:00 2001 From: Niels Braczek Date: Mon, 19 Dec 2022 23:59:01 +0100 Subject: [PATCH 4/7] Add Entrance vote result --- proposed/decoupling-output-meta.md | 35 +++++++++++++++++++++++++++--- 1 file changed, 32 insertions(+), 3 deletions(-) diff --git a/proposed/decoupling-output-meta.md b/proposed/decoupling-output-meta.md index 319662e..f00b8c1 100644 --- a/proposed/decoupling-output-meta.md +++ b/proposed/decoupling-output-meta.md @@ -45,7 +45,7 @@ less, it will even be possible to offer output layers with completely different ### 6.2 Sponsors -* N/A +* Llewellyn van der Merwe ### 6.3 Contributors @@ -53,8 +53,37 @@ less, it will even be possible to offer output layers with completely different ## 7. Votes -* **Entrance Vote:** _(not yet taken)_ -* **Acceptance Vote:** _(not yet taken)_ +### Entrance Vote: PROD2022/016 + +| Voter | Vote | +|---------------------------------------------|-----:| +| Benjamin Trenkle | +1 | +| Christiane Maier-Stadtherr / Viviana Menzel | 0 | +| Crystal Dionysopoulos | -1 | +| David Jardin | 0 | +| Franciska Perisa | 0 | +| Hannes Papenberg | +1 | +| Harald Leithner | +1 | +| Jacob Waisner | 0 | +| Llewellyn van der Merve | +1 | +| Mike Brandner | +1 | +| Niels Braczek | +1 | +| Olivier Buisard | +1 | +| Philip Walton | +1 | +| Robert Deutz | 0 | +| Roland Dalmulder | -1 | +| Shirielle Williams | 0 | +| Shivam Raiput | +1 | +| Sigrid Gramlinger | -1 | +| Tobias Zulauf | -1 | +| **Result: PASSED** | | +| **in favor** | 9 | +| **against** | 4 | +| **abstentions** | 6 | +| **no vote** | 0 | + +### Acceptance Vote: +_(not yet taken)_ ## 8. Relevant Links From 143ea0ffbca240b0dbf75ba1e1ed3982921db820 Mon Sep 17 00:00:00 2001 From: Niels Braczek Date: Tue, 20 Dec 2022 01:58:52 +0100 Subject: [PATCH 5/7] Fix links --- index.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/index.md b/index.md index 2ea37c7..e30d136 100644 --- a/index.md +++ b/index.md @@ -29,9 +29,9 @@ The sponsor is responsible for managing the review stage and votes. | Num | Title | Editor | Sponsor | |:---:|-----------------------------------------|-----------------------------------------------------|------------------------------------------------------------------------| -| 1 | [Decpoupling Output](decoupling-output) | Niels Braczek | Llewellyn van der Merwe | -| 2 | [Form Admin](form-admin) | Niels Braczek | Llewellyn van der Merwe | -| 3 | [Simple CCK](simple-cck) | Niels Braczek | Llewellyn van der Merwe | +| 1 | [Decpoupling Output][decoupling-output] | Niels Braczek | Llewellyn van der Merwe | +| 2 | [Form Admin][form-admin] | Niels Braczek | Llewellyn van der Merwe | +| 3 | [Simple CCK][simple-cck] | Niels Braczek | Llewellyn van der Merwe | ### Pre-Draft From 8338742c5b4d172de9dc259d16c18d6aacfc88bd Mon Sep 17 00:00:00 2001 From: Niels Braczek Date: Wed, 24 Aug 2022 23:46:11 +0200 Subject: [PATCH 6/7] Summary and Why Bother --- proposed/decoupling-output-meta.md | 65 ++++++++++++++++++++++++++++++ proposed/decoupling-output.md | 45 +++++++++++++++++++++ 2 files changed, 110 insertions(+) create mode 100644 proposed/decoupling-output-meta.md create mode 100644 proposed/decoupling-output.md diff --git a/proposed/decoupling-output-meta.md b/proposed/decoupling-output-meta.md new file mode 100644 index 0000000..319662e --- /dev/null +++ b/proposed/decoupling-output-meta.md @@ -0,0 +1,65 @@ +# Decoupling Output Meta Document + +## 1. Summary + +_The separation of the visual preparation and presentation of the content from its management is what we call +decoupling of the output._ + +The aim of this specification is to decouple the output layer from the core of the CMS so that necessary changes to the +CMS code require as few changes as possible to the templates and their overrides. + +## 2. Why Bother? + +Every major version so far has stirred up resentment among users because not only programme code but also templates, +layouts and overrides had to be revised. If we succeed in reducing the points of contact between the CMS core and the +actual views to interfaces, not only will the adaptation effort for templates, layouts and overrides be considerably +less, it will even be possible to offer output layers with completely different frontend libraries than before. + +## 3. Scope + +### 3.1 Goals + +### 3.2 Non-Goals + +## 4. Approaches + +### 4.1 Approach 1 + +#### 4.1.1 Projects Using Approach 1 + +### 4.2 Approach 2 + +#### 4.2.1 Projects Using Approach 2 + +### 4.3 Comparison of Approaches + +### 4.4 Chosen Approach + +## 5. Design Decisions + +## 6. People + +### 6.1 Editor(s) + +* Niels Braczek + +### 6.2 Sponsors + +* N/A + +### 6.3 Contributors + +* N/A + +## 7. Votes + +* **Entrance Vote:** _(not yet taken)_ +* **Acceptance Vote:** _(not yet taken)_ + +## 8. Relevant Links + +_**Note:** Order descending chronologically._ + +## 9. Errata + +... diff --git a/proposed/decoupling-output.md b/proposed/decoupling-output.md new file mode 100644 index 0000000..ca4f072 --- /dev/null +++ b/proposed/decoupling-output.md @@ -0,0 +1,45 @@ +# Decoupling Output + +This document describes ... + +The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", +"SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be +interpreted as described in [RFC 2119][]. + +[RFC 2119]: http://tools.ietf.org/html/rfc2119 + +### References + +- [RFC 2119][]: Key words for use in RFCs to Indicate Requirement Levels + +## 1. Specification + +### 1.1 Spec A + +### 1.2 Spec B + +## 2. Interfaces + +### 2.1 Interface A + +The following interface MUST be implemented by compatible ... + +```php +namespace ...; + +interface ... +{ +} +``` + +### 2.2 Inteface B + +The following interface MUST be implemented by compatible ... + +```php +namespace ...; + +interface ... +{ +} +``` From ffa3a98a8111214962536ceae891f7e04e95262b Mon Sep 17 00:00:00 2001 From: Niels Braczek Date: Mon, 19 Dec 2022 23:59:01 +0100 Subject: [PATCH 7/7] Add Entrance vote result --- proposed/decoupling-output-meta.md | 35 +++++++++++++++++++++++++++--- 1 file changed, 32 insertions(+), 3 deletions(-) diff --git a/proposed/decoupling-output-meta.md b/proposed/decoupling-output-meta.md index 319662e..f00b8c1 100644 --- a/proposed/decoupling-output-meta.md +++ b/proposed/decoupling-output-meta.md @@ -45,7 +45,7 @@ less, it will even be possible to offer output layers with completely different ### 6.2 Sponsors -* N/A +* Llewellyn van der Merwe ### 6.3 Contributors @@ -53,8 +53,37 @@ less, it will even be possible to offer output layers with completely different ## 7. Votes -* **Entrance Vote:** _(not yet taken)_ -* **Acceptance Vote:** _(not yet taken)_ +### Entrance Vote: PROD2022/016 + +| Voter | Vote | +|---------------------------------------------|-----:| +| Benjamin Trenkle | +1 | +| Christiane Maier-Stadtherr / Viviana Menzel | 0 | +| Crystal Dionysopoulos | -1 | +| David Jardin | 0 | +| Franciska Perisa | 0 | +| Hannes Papenberg | +1 | +| Harald Leithner | +1 | +| Jacob Waisner | 0 | +| Llewellyn van der Merve | +1 | +| Mike Brandner | +1 | +| Niels Braczek | +1 | +| Olivier Buisard | +1 | +| Philip Walton | +1 | +| Robert Deutz | 0 | +| Roland Dalmulder | -1 | +| Shirielle Williams | 0 | +| Shivam Raiput | +1 | +| Sigrid Gramlinger | -1 | +| Tobias Zulauf | -1 | +| **Result: PASSED** | | +| **in favor** | 9 | +| **against** | 4 | +| **abstentions** | 6 | +| **no vote** | 0 | + +### Acceptance Vote: +_(not yet taken)_ ## 8. Relevant Links