Skip to content
This repository has been archived by the owner on Jul 6, 2020. It is now read-only.

Commit

Permalink
Merge pull request #8 from solid/add-readme
Browse files Browse the repository at this point in the history
The new community README
  • Loading branch information
timbl committed Jan 11, 2019
2 parents 1021e93 + f581ccf commit ec3ee91
Showing 1 changed file with 69 additions and 2 deletions.
71 changes: 69 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,69 @@
# community
Documentation, guidelines, discussion, and best practices for the Solid community.
# Solid Community

The community is working on the [open source initiative of Solid](https://github.com/solid) with Community Leader Tim Berners-Lee. In order to promote transparency around the Solid community issues around governance will be documented in this community repository.

## Table of Contents
* [Mission and Values](#mission-and-values)
* [Spec, Plan, and Documentation](#spec-plan-and-documentation)
* [Community Roles](#community-roles)
* [Community Support Meetings](#community-support-meetings)
* [Checks and Balances](#checks-and-balances)
* [Processes](#processes)
* [Licensing](#licensing)
* [Pod Providers and WebID Providers](#pod-providers-and-webid-providers)
* [Tools](#tools)
* [Solid Events](#solid-events)
* [Advisory Board](#advisory-board)


## Mission and Values
To give individuals control over their data when using the web to open up innovation on the web.

## Spec, Plan, and Documentation
To make suggestions to the the [Solid spec](https://github.com/solid/solid-spec), Solid plan (plan.md), or [Solid documentation](documentation.md) please submit a pull request or an issue on github. Suggestions will be incorporated by the community manager. If there is a difference of opinion about the incorporation of a suggestion, the community managaer and relevant community members will first talk to try and find a compromise. When a compromise cannot be found the community leader will make the final judgement.

## Community Roles
You can find a list of the [various roles within the Solid community](community-roles.md) as well as the responsibilities associated with each role. Individuals will be appointed to the roles by the community leader.

## Community Support Meetings
There are weekly recurring [community support meetings](community-support-meeting-agenda-and-minutes.md) via online calls moderated by the community manager. Individuals with specified community roles need to attend the community support meetings if stated in their role description. To make a suggestion for an agenda item at the community support meeting please submit a pull request directly to the [community support meeting agenda](community-support-meeting-agenda-and-minutes.md). Suggestions will be incorporated by the community manager. If there is a difference of opinion about the incorporation of a suggestion, the community managaer and relevant community members will first talk to try and find a compromise. When a compromise cannot be found the community leader will make the final judgement.

## Checks and Balances
To suggest a specific change to the Solid code, submit a pull request. Pull requests will be processed as described below.

Solid has a [code of conduct](code-of-conduct.md) which all community members must keep in mind when contributing to Solid. If you would like to report an issue around the code of conduct or have a concern about Solid governance, please contact the community manager or submit an issue. The community manager will tag issues related to the code of conduct with the code of conduct tag. The community manager will be responsible for proposing a solution and speaking to the relevant parties to resolve the issue. If a compromise around any difference of opinion cannot be found, the community leader will make the final judgement on a solution.

To make suggestions around Solid governance, roles, plans, review process, themes to discuss at Solid World or for the advisory board please contact the community manager or submit an issue. The community manager will add the ‘governance suggestion’ tag to those issues. The community manager will be responsible for incorporating suggestions. If there is a difference of opinion to which a compromise cannot be met the community leader will make the final judgement.

## Processes
Step 1. Submission
Submit a GitHub pull request if you would like to make a specific change to code or text or a GitHub issue if you would like to raise a general point. If you are working on an issue or pull request assign yourself to that issue to let everyone you are working on it.

Step 2. Consensus
Community members can share ideas and propose solutions on each pull request or issue.

Step 3. Merge
The relevant project release manager will judge and implement the merge. If there is a difference of opinion about a merge between the contributor and the relevant project release manager, they will first talk to try and find a compromise. When a compromise cannot be found the community leader will make the final judgement.

If you are working on Solid [let others know your processes] (processes.md).

## Licensing
[Solid code is licensed](licence.md) under the MIT license and there are defined [Solid logo usage guidelines](Solid-logo.md).

## Pod Providers and WebID Providers
If you would like to become a [Pod Providers](pod-providers.md) and/or a [WebID Provider](webid-provider.md) you can let others know.

## Tools
There are several existing Solid community communications channels including:

* [Discourse](https://forum.solidproject.org/): To get started [introduce yourself and get to know others](https://forum.solidproject.org/t/welcome-to-the-solid-forum-please-introduce-yourself-here-great-to-have-you-on-board/440/20) in the community.
* [Gitter](https://gitter.im/solid/chat)
* [Reddit](https://www.reddit.com/r/SOLID/submit)

## Solid Events
[Solid events](solid-events.md) are run by community members in various cities around the world. Solid events provide an opportunity for community members to meet and talk about Solid in person. If you decide to run a Solid event [let others know about it](solid-events.md).

To facilitate inclusion of all interested parties the community manager organises Solid World monthly event where anyone can tune in for a one-hour conversation around a set theme. To propose a theme for Solid World conversations, contact the community manager.

## Advisory Board
The Solid advisory board has the role of constructing a plan on how to uphold the original Solid values and mission. The plan needs to promote efficient, effective, inclusive, and transparent governance. The Solid advisory board should submit the plan to the community leader via the community manager. Once the plan has been submitted the advisory board will be dismantled. Advisory board members will be appointed by the Community Leader with the support of the Community Manager. The advisory board will take part in several workshops to discuss the governance issues together. The community manager will be coordinating the workshops. If you would like to suggest an issue to be addressed by the advisory board, please contact the community manager.

0 comments on commit ec3ee91

Please sign in to comment.