From 2ac5cd1c9132e72d4edf6feed36120d6f293dcdb Mon Sep 17 00:00:00 2001 From: Ruben Verborgh Date: Fri, 18 Mar 2022 17:06:30 +0000 Subject: [PATCH 1/3] Rename repo-overview.md to repositories.md. --- repo-overview.md => repositories.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename repo-overview.md => repositories.md (100%) diff --git a/repo-overview.md b/repositories.md similarity index 100% rename from repo-overview.md rename to repositories.md From fbc26beabd84a94167458e3be845dce02878ebd2 Mon Sep 17 00:00:00 2001 From: Ruben Verborgh Date: Fri, 18 Mar 2022 17:44:44 +0000 Subject: [PATCH 2/3] Describe inclusion criteria for repositories. --- repositories.md | 60 ++++++++++++++++++++++++------------------------- 1 file changed, 29 insertions(+), 31 deletions(-) diff --git a/repositories.md b/repositories.md index 23699b1..a4b2c07 100644 --- a/repositories.md +++ b/repositories.md @@ -1,31 +1,29 @@ -# Solid GitHub Repository Overview - -The [Solid GitHub organisation](https://github.com/solid/) contains several repositories. This document aims to provide an overview of the aim of each of the repositories and who is actively maintaining each repository. - -If you have more information [submit an issue](https://github.com/solid/process/issues) and a Solid Administrator will make a decision on how to incorporate the issue into this file. - -The following describes the governance, administration, and communication via the website: - -| Activity | Associated Repositories | Individuals Currently Active | -| ------------- | ------------- | ------------- | -| Administration | [owner on Solid members](https://github.com/orgs/solid/people) | Solid Director, Solid Manager, Administrators | -| Process | [Process](https://github.com/solid/process) | Solid Director, Solid Manager | -| solidproject.org | [solidproject.org](https://github.com/solid/solidproject.org), [solid github io](https://github.com/solid/solid.github.io) | Creators | -| Communication | [Communication](https://github.com/solid/communication) | Solid Director, Solid Manager | -| Roadmap | [Roadmap](https://github.com/solid/roadmap) | Solid Director, Solid Manager | - -These are the key [respositories associated to the specification development](https://github.com/search?q=topic%3Aspecification+org%3Asolid&type=Repositories) which are tagged 'specification' and are managed by the [Editors](https://github.com/orgs/solid/teams/editors) with input from the [Panellists](https://github.com/orgs/solid/teams/panels) - -| Activity | Associated Repositories | Individuals Currently Active | -| ------------- | ------------- | ------------- | -| Latest Version of the Specification | [Specification](https://github.com/solid/specification) | Editors | -| Specification Authoring | [authorization panel](https://github.com/solid/authorization-and-access-control-panel/issues/), [authentication panel](https://github.com/solid/authentication-panel), [interoperability panel](https://github.com/solid/interoperability-panel), | [Panellists](https://github.com/solid/process/blob/master/panels.md) | -| Test Suite Development | [Test Suite](https://github.com/solid/test-suite) | Editors | - -## Running Code - -There are several implementations of Solid in the Solid GitHub that can be found in [repositories tagged 'running-code'](https://github.com/search?q=topic%3Arunning-code+org%3Asolid&type=Repositories). IMEC and more specifically, [these team members](https://github.com/orgs/solid/teams/imec/members) are responsible for the [repositories listed here](https://github.com/orgs/solid/teams/imec/repositories). [These team members](https://github.com/orgs/solid/teams/other/members) are responsible for [these repositories](https://github.com/orgs/solid/teams/other/repositories). - -## Archived - -There are over thirty [archived repositories](https://github.com/solid?q=&type=archived&language=) with information that is now covered by solidproject.org or a reference to currently inactive panels. +# Repositories on github.com/solid +The [Solid GitHub organisation](https://github.com/solid/) +contains repositories that are managed by the [Solid Team](https://github.com/solid/team/), +covering the Solid specification and its processes and artifacts, +and public communication on the Solid project. + +This document describes which repositories belong under _github.com/solid_, +and which repositories belong elsewhere. +This also pertains to other resources associated with those repositories, +such as Gitter chat channels bearing the same name. + +## Repositories that are part of github.com/solid +Repositories under github.com/solid need to satisfy the condition that: +- their contents are managed by either: + - the [Solid administrators](https://github.com/solid/process/blob/main/administrators.md) + - the [Solid creators](https://github.com/solid/process/blob/main/creators.md) + - the [Solid editors](https://github.com/solid/process/blob/main/editors.md) + +Additionally, they need to satisfy one or more of the following conditions: +- they are specification documents +- they are documents related to processes for advancing the specification +- they are guidelines or working documents for people within the Solid community +- they are materials for Solid project websites (such as [solidproject.org](https://solidproject.org/)) + +## Repositories that are not part of github.com/solid +Repositories that satisfy one or more of the conditions below +belong in other GitHub organisations or on other third-party places: +- they are not managed by Solid administrators, creators, or editors +- they are specific specification implementations or program code (that is not contributing to the display of the documents listed above) From 00b529736381cd7d0f5201bfc4828cf29f8cc448 Mon Sep 17 00:00:00 2001 From: Ruben Verborgh Date: Wed, 23 Mar 2022 16:11:22 +0000 Subject: [PATCH 3/3] Clarify language. Co-authored-by: Ted Thibodeau Jr --- repositories.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/repositories.md b/repositories.md index a4b2c07..76474bc 100644 --- a/repositories.md +++ b/repositories.md @@ -10,8 +10,8 @@ This also pertains to other resources associated with those repositories, such as Gitter chat channels bearing the same name. ## Repositories that are part of github.com/solid -Repositories under github.com/solid need to satisfy the condition that: -- their contents are managed by either: +Repositories under github.com/solid need to satisfy the condition that their +contents are managed by one or more of the following: - the [Solid administrators](https://github.com/solid/process/blob/main/administrators.md) - the [Solid creators](https://github.com/solid/process/blob/main/creators.md) - the [Solid editors](https://github.com/solid/process/blob/main/editors.md)