Skip to content

Commit 7558a71

Browse files
committed
Add section to purpose-and-process on endorsement
1 parent 2ad1720 commit 7558a71

File tree

3 files changed

+18
-12
lines changed

3 files changed

+18
-12
lines changed

_index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,4 +15,5 @@ Community discussions take place on the
1515
SPEC development takes place in the [SPEC repository](https://github.com/scientific-python/specs).
1616

1717
If you want to **contribute a SPEC**, start by reading [SPEC Purpose and Process](/specs/purpose-and-process).
18+
Core projects may also want to [endorse a SPEC](/specs/purpose-and-process#endorsing-a-spec).
1819
Contributors must adhere to our [code of conduct](https://scientific-python.org/code_of_conduct/).

core-projects/_index.md

Lines changed: 1 addition & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -71,14 +71,7 @@ The 3-clause (also called "modified" or "new") BSD license is by far the most co
7171

7272
### How does a Core Project endorse a SPEC?
7373

74-
Core Projects use their project-specific discussion and decision making mechanisms to decide whether to support a SPEC.
75-
Certain SPECs may, for example, require Core Projects to create their _own_ enhancement
76-
proposals to expand on implementation details.
77-
78-
Once a Core Project decides to endorse a SPEC, they add their project
79-
name to the `endorsed-by` field in the SPEC header via a pull request against
80-
the [scientific-python/specs](https://github.com/scientific-python/specs)
81-
repository.
74+
See [purpose and process](/specs/purpose-and-process#endorsing-a-spec).
8275

8376
### How many Core Projects should there be?
8477

purpose-and-process/_index.md

Lines changed: 16 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -30,10 +30,10 @@ will benefit the ecosystem as a whole.
3030

3131
Projects decide for themselves whether to adopt any given SPEC—often, this
3232
would be through team consensus.
33-
A SPEC may not be a good fit for every single project, and thus there is no
34-
expectation that all SPECs must be adopted by all projects.
35-
That said, SPECs serve their purpose through being adopted by
36-
several projects—and their authority stems from the extent to which they are.
33+
They may look towards endorsements by [Core Projects](/specs/core-projects) as a signal to help them decide.
34+
A SPEC may not be a good fit for a project, and thus there is no
35+
expectation that all SPECs must be adopted by all projects (in fact, even Core Projects that endorse a SPEC—i.e., signaling that they think it is a good idea—may choose not to adopt it themselves).
36+
Still, SPECs best serve their purpose of communicating cross-project concepts when adopted by numerous projects—and their authority stems from the extent to which they are.
3737

3838
Participants in the SPEC process must adhere to our
3939
[Code of Conduct](https://scientific-python.org/code_of_conduct/).
@@ -296,6 +296,18 @@ Leave the `draft` field set to `true` and the `endorsed-by` field empty.
296296
Once the SPEC is in reasonable shape, file a pull request against the
297297
[SPEC repository](https://github.com/scientific-python/specs).
298298

299+
## Endorsing a SPEC
300+
301+
[Core Projects](/specs/core-projects) may signal their approval of a SPEC by _endorsing_ it.
302+
This endorsement makes it more likely that other projects will _adopt_ it.
303+
Endorsing a SPEC does _not_, however, mean that a Core Project needs to _adopt_ a SPEC, although they typically would if feasible.
304+
Core Projects use their project-specific discussion and decision making mechanisms to decide whether to endorse a SPEC.
305+
306+
Once a Core Project decides to endorse a SPEC, they add their project
307+
name to the `endorsed-by` field in the SPEC header via a pull request against
308+
the [scientific-python/specs](https://github.com/scientific-python/specs)
309+
repository.
310+
299311
## Notes
300312

301313
[^newspec]:

0 commit comments

Comments
 (0)