Add editor assignments, permission scheme, and substantive changes

README.md

@@ -20,6 +20,10 @@ Domains may be technical, non-technical, or some combination of the two. For exa
 
 A list of Solid Panels is maintained at [panels.md](panels.md). This listing helps people find panels they may want to participate in, and helps editors find panels to consult as part of the editorial process.
 
+Panels may request to have a repository created within the [Solid Github Organization](https://github.com/solid). These requests should be made by submitting an issue to [solid/process](https://github.com/solid/process). The request should include the proposed name of the repository, and how it will be used. Any editor may reject a proposed name and request an alternative. All panel members will receive [_Maintain Permissions_](https://help.github.com/en/articles/repository-permission-levels-for-an-organization#permission-levels-for-repositories-owned-by-an-organization) on the panel repository, unless it is subject to editorial review, which would require that it employ a [different permission structure](#repositories). Panel repositories that are inactive for more than six months may be archived by Solid Administrators.
+
+Panels may request to have a gitter channel created within the [Solid Gitter Organization](https://gitter.im/solid). These requests should be made by submitting an issue to [solid/process](https://github.com/solid/process).
+
 ## Stakeholders
 
 Stakeholders are those affected by normative changes to the Solid Specification, Solid Roadmap, or Supporting Documentation. There are two types of Stakeholders; [Solid Users](#solid-users) and [Solid Implementers](#solid-implementers). It is important to consider them both when proposing changes, and adhering to the W3C [priority of constituencies](https://www.w3.org/TR/html-design-principles/#priority-of-constituencies) is encouraged. A Stakeholder may be both a user and an implementer.
@@ -48,8 +52,6 @@ Anyone may propose improvements to the Solid Specification, Solid Roadmap, or Su
 - Make a suggestion on the Solid W3C Community Group mailing list to form a new Solid Panel, or join an existing Solid Panel
 - Propose an item for the W3C Solid Community Group call
 
-Proposals for substantive changes to the Solid Specification, Solid Roadmap, or Supporting Documentation go through an editorial review process. A change is considered substantive when it alters the normative text of the Solid Specification or the Solid Roadmap.
-
 Any proposal must be realistic and reasonable to implement, preferably with example implementations, and demonstrable support from Implementers.
 
 Any proposal should also be accompanied with a reasonable explanation of the need for the proposed change. For example:
@@ -64,23 +66,37 @@ When there are objections, notify the Solid Panels and Stakeholders about the fi
 
 ### Reviewing proposals
 
-Candidate proposals to the Solid Specification, Solid Roadmap, or Supporting Documentation submitted for review go through an editorial process before they are accepted.
+Candidate Proposals to change the Solid Specification, Solid Roadmap, or Supporting Documentation must be submitted for editorial review before they are accepted, along with the results of any votes taken.
+
+An Editor determines whether a Candidate Proposal includes a substantive change and marks it accordingly. If there is any disagreement among Editors, the Candidate Proposal will be automatically marked as including a substantive change.
+
+Candidate Proposals with substantive changes require three Editors who are assigned to the material being modified to actively approve the proposal, with no Editors from the Editorial Team actively rejecting. If there are less than three Editors assigned to the material being modified, then other Editors from the Editorial Team may participate.  Editors may abstain. Candidate Proposals with substantive changes must remain open for at least one week before final acceptance. If an Editor does not vote by the end of that week it will be assumed that they abstained. Once the Candidate Proposal has successfully passed editorial review and the specified wait-time has elapsed, it may be merged by an assigned Editor.
 
-Candidate proposals and the results of any vote related to the same need to be put forward to the editors for review. For the proposal to be accepted, three editors need to actively approve with no editors actively rejecting. Editors may abstain. A proposal must be open for at least one week before final acceptance. If an editor does not vote by the end of that week it will be assumed that the editor abstained.
+Candidate Proposals without substantive changes require one Editor assigned to the material being modified to actively approve the proposal, with no Editors from the Editorial Team actively rejecting, and may be merged immediately by an assigned Editor. An assigned Editor may approve and merge their own non-substantive changes. Anyone from the Editorial Team has the right to revert a non-substantive change, but are encouraged to communicate with the assigned Editor that merged it first. Any revert must be accompanied by a reasonable explanation. If the change is reverted because they believe it to be substantive, that must be included in the explanation.
 
-### Becoming an Editor
+## Editorial Structure
 
-Editors are appointed directly by the Solid Director. Editors are listed at [editors.md](editors.md) along with their contact details and affiliations. Anyone may submit a request to be an editor. These requests are not reviewed by other editors. They are reviewed directly by the Solid Director.
+Editor appointments and their respective assignments are made by the Solid Director. The Editorial Team is comprised of all the Editors appointed by the Solid Director, who are listed at [editors.md](editors.md), along with their assignments, contact details, and affiliations. Anyone may apply to be an Editor, and must include one or more requested editorial assignments as part of their application. These requests are not reviewed by other Editors. They are reviewed only by the Solid Director. Editor applications that can demonstrate the support of a relevant panel or group of community members will be favorably considered.
 
 The Solid Manager, who is also an editor, is appointed by the Solid Director. The Solid Manager is responsible for formalizing the outcome of any votes.
 
+Editors belong to the [Editorial Team](https://github.com/orgs/solid/teams/editors) in the [Solid GitHub Organization](https://github.com/solid).
+
+### Repositories
+
+Repositories requiring editorial review are listed in [editors.md](editors.md#editorial-assignments). Each repository has one or more assigned editors, and only assigned editors are permitted to merge into the master branch of these repositories, per the [proposal review process](#reviewing-proposals).
+
+Editors have [_Admin Permissions_](https://help.github.com/en/articles/repository-permission-levels-for-an-organization#permission-levels-for-repositories-owned-by-an-organization) on the repositories they are assigned to, and are permitted to grant [_Write Permissions_](https://help.github.com/en/articles/repository-permission-levels-for-an-organization#permission-levels-for-repositories-owned-by-an-organization) to other contributing authors on the same. All members of the Editorial Team have [_Write Permissions_](https://help.github.com/en/articles/repository-permission-levels-for-an-organization#permission-levels-for-repositories-owned-by-an-organization) on all repositories requiring editorial review listed in [editors.md](editors.md).
+
 ## Administration
 
 Administrators are granted privileged access to control the tools, systems, and services used for advancing the Solid Specification, Solid Roadmap, and Supporting Documentation. This includes the [Solid GitHub](https://github.com/solid) organization, [Solid Gitter](https://gitter.im/solid/home) channels, the [Solid Forum](https://forum.solidproject.org), and the [Solid Website](https://www.solidproject.org).
 
+Administrators belong to the [Administrators Team](https://github.com/orgs/solid/teams/administrators) in the [Solid GitHub Organization](https://github.com/solid) and have [_Admin Permissions_](https://help.github.com/en/articles/repository-permission-levels-for-an-organization#permission-levels-for-repositories-owned-by-an-organization) on all repositories therein. Administrators have [_Owner Permissions_](https://help.github.com/en/articles/permission-levels-for-an-organization#permission-levels-for-an-organization) for the [Solid GitHub Organization](https://github.com/solid).
+
 ### Becoming an Administrator
 
-Administrators are appointed directly the Solid Director. Administrators are listed at [administrators.md](administrators.md) along with their contact details and affiliations. Anyone may request to be an administrator. Administrator requests are not reviewed by other Administrators. They are reviewed only by the Solid Director.
+Administrators are appointed by the Solid Director. Administrators are listed at [administrators.md](administrators.md) along with their contact details and affiliations. Anyone may apply to be an Administrator. Administrator applications are not reviewed by other Administrators. They are reviewed only by the Solid Director.
 
 The Solid Manager, who is also an administrator, is appointed by the Solid Director and is responsible for implementing the vision of the Solid Director.
 

editors.md

@@ -1,7 +1,125 @@
 # Solid Editors
 
-Below is a listing of Solid Editors. See [Reviewing Proposals](README.md#reviewing-proposals.md) for an explanation of how the editorial process is used to review and accept changes to Solid Specifications, the Solid Roadmap, and Supporting Documentation.
+Below is a listing of the Solid Editorial Team and their respective assignments. See [Reviewing Proposals](README.md#reviewing-proposals.md) for an explanation of how the editorial process is used to review and accept changes to Solid Specifications, the Solid Roadmap, and Supporting Documentation.
+
+## Editorial Team
 
 | Name      | WebID      |
 | --------- | ---------- |
 | [Tim Berners-Lee](https://github.com/timbl) | [WebID](https://www.w3.org/People/Berners-Lee/card#i) |
+
+## Editorial Assignments
+
+Editorial assignments are broken into three sections; [Solid Specification](#solid-specification), [Solid Roadmap](#solid-roadmap), and [Supporting Documentation](#supporting-documentation).
+
+### Solid Specification
+
+The Solid Specification covers a broad range of topics, from resource access and decentralized authentication to data portability and querying. Consequently, it requires a group of individuals with a wide range of skillsets to provide thorough editorial review of proposals to extend or alter the specification.
+
+Editorial assignments to the specification are by topic. A given editor may be assigned to one or more topics. Some topics may have dedicated primary documents, while other topics may occur throughout the specification.
+
+-   [Resource Access](#resource-access)
+-   [Identity](#identity)
+-   [Authentication](#authentication)
+-   [Authorization](#authorization)
+-   [Events and Notifications](#events-and-notifications)
+-   [Data Interoperability](#data-interoperability)
+-   [Data Portability](#data-portability)
+-   [Auditing](#auditing)
+-   [Querying](#querying)
+-   [Cryptography](#cryptography)
+-   [Security](#security)
+
+#### Resource Access
+Pertaining to the access of resources in a data pod over a network via HTTP and LDP  
+__Assigned Editors:__  *No editors assigned yet*   
+__Primary Documents:__  [solid/specification/resource-access](https://github.com/solid/specification/blob/master/main/resource-access.bs)
+
+#### Identity
+Pertaining to mechanisms that universally identify people or applications.  
+__Assigned Editors:__  *No editors assigned yet*   
+__Primary Documents:__
+
+#### Authentication
+Pertaining to mechanisms that authenticate a person or application for the purposes of accessing resources in a data pod.  
+__Assigned Editors:__  *No editors assigned yet*   
+__Primary Documents:__ [solid/specification/webid-oidc](https://github.com/solid/specification/tree/master/webid-oidc), [solid/specification/webid-tls](https://github.com/solid/specification/tree/master/webid-tls), [solid/webid-oidc-spec](https://github.com/solid/webid-oidc-spec)
+
+#### Authorization
+Pertaining to mechanisms that control the access a given agent has to read or manipulate resources in a data pod.  
+__Assigned Editors:__  *No editors assigned yet*   
+__Primary Documents:__ [solid/specification/resource-access](https://github.com/solid/specification/blob/master/main/resource-access.bs), [solid/specification/wac](https://github.com/solid/specification/tree/master/wac), [solid/web-access-control-spec](https://github.com/solid/web-access-control-spec)
+
+#### Events and Notifications
+Pertaining to mechanisms that process and/or emit events between pods and agents, or other pods.  
+__Assigned Editors:__  *No editors assigned yet*   
+__Primary Documents:__
+
+#### Data Interoperability
+Pertaining to mechanisms that ensure disparate applications or agents can safely and seamlessly read and write the data they need.  
+__Assigned Editors:__  *No editors assigned yet*   
+__Primary Documents:__
+
+#### Data Portability
+Pertaining to mechanisms that ensure the portability of data stored in a data pod such that it can be safely migrated between conformant Solid server implementations, as well as exported to other mediums.  
+__Assigned Editors:__  *No editors assigned yet*   
+__Primary Documents:__
+
+#### Data Models
+Pertaining to core vocabularies and data shapes essential to a working ecosystem of data pods and applications.  
+__Assigned Editors:__ *No editors assigned yet*  
+__Primary Documents:__ [solid/vocab](https://github.com/solid/vocab)
+
+#### Auditing
+Pertaining to the mechanisms through which access and manipulation events of resources in a data pod are recorded and accessible.  
+__Assigned Editors:__  *No editors assigned yet*   
+__Primary Documents:__
+
+#### Querying
+Pertaining to the mechanisms, such as SPARQL and TPF, through which a given agent can provide query parameters to a data pod and receive results satisfying the same.  
+__Assigned Editors:__  *No editors assigned yet*   
+__Primary Documents:__
+
+#### Cryptography
+Pertaining to the mechanisms through which cryptographic techniques are employed to provide data privacy, data integrity, and verifiable information.  
+__Assigned Editors:__ *No editors assigned yet*    
+__Primary Documents:__
+
+#### Security
+Pertaining to mechanisms used and considerations taken when securing a data pod, a conformant server implementation, and/or the immediate ecosystem around them.  
+__Assigned Editors:__ *No editors assigned yet*  
+__Primary Documents:__ [solid/specification/security](https://github.com/solid/specification/blob/master/main/security.bs)
+
+---
+
+### Solid Roadmap
+
+The Solid Roadmap includes the vision, goals, direction, and key success factors for the Solid and its surrounding ecosystem.  
+__Assigned Editors:__ *No editors assigned yet*  
+__Primary Documents:__ [solid/roadmap](https://github.com/solid/roadmap)
+
+---
+
+### Supporting Documentation
+
+The Solid Specification, Roadmap, and the greater ecosystem are supported by various forms of documentation and supplementary content, from the process and updates to web sites and tutorials.
+
+#### Solid Process
+Official process that details how changes to the Solid Specification, Solid Roadmap, and Supporting Documentation may be proposed and accepted.  
+__Assigned Editors:__ *No editors assigned yet*  
+__Primary Documents:__ [solid/process](https://github.com/solid/process)
+
+#### solidproject.org
+The official project website.  
+__Assigned Editors:__ *No editors assigned yet*  
+__Primary Documents:__ [solid/solidproject.org](https://github.com/solid/solidproject.org)
+
+#### solid.mit.edu
+Home of the original Solid MIT project.  
+__Assigned Editors:__ *No editors assigned yet*  
+__Primary Documents:__ [solid/solid.mit.edu](https://github.com/solid/solid.mit.edu)
+
+#### Solid Information
+A collection of informational resources about Solid and its ecosystem.
+__Assigned Editors:__ *No editors assigned yet*  
+__Primary Documents:__ [solid/information](https://github.com/solid/information), [solid/solid](https://github.com/solid/solid)