From 24d8c35592de2e310a6c9e15fce7f18dcddceea0 Mon Sep 17 00:00:00 2001
From: Azrenbeth Welcome to Synapse This document aims to get you started with contributing to this repo! Everyone is welcome to contribute code to matrix.org
projects, provided that they are willing to
@@ -234,7 +197,7 @@ follow a simple 'inbound=outbound' model for contributions: the act of
submitting an 'inbound' contribution means that the contributor agrees to
license the code under the same terms as the project's overall 'outbound'
license - in our case, this is almost always Apache Software License v2 (see
-LICENSE).Contributing
-
1. Who can contribute to Synapse?
The code of Synapse is written in Python 3. To do pretty much anything, you'll need a recent version of Python 3.
The source code of Synapse is hosted on GitHub. You will also need a recent version of git.
@@ -268,16 +231,19 @@ pip install toxFix your favorite problem or perhaps find a Good First Issue to work on.
Synapse's code style is documented here. Please follow -it, including the conventions for the sample configuration -file.
-There is a growing amount of documentation located in the docs +
Synapse's code style is documented +here. +Please follow it, including the conventions for the +sample configuration file.
+There is a growing amount of documentation located in the +docs directory. This documentation is intended primarily for sysadmins running their -own Synapse instance, as well as developers interacting externally with -Synapse. docs/dev exists primarily to house documentation for -Synapse developers. docs/admin_api houses documentation -regarding Synapse's Admin API, which is used mostly by sysadmins and external -service developers.
+own Synapse instance, as well as developers interacting externally with Synapse. +docs/development +exists primarily to house documentation for Synapse developers. +docs/admin_api +houses documentation regarding Synapse's Admin API, which is used mostly by sysadmins +and external service developers.If you add new files added to either of these folders, please use GitHub-Flavoured Markdown.
Some documentation also exists in Synapse's GitHub
@@ -521,7 +487,7 @@ flag to By now, you know the drill! There are some notes for those with commit access to the project on how we
-manage git here.git commit
, which uses the name and email set in your
Notes for maintainers on merging PRs etc
That's it! Matrix is a very open and collaborative project as you might expect given our obsession with open communication. If we're going to successfully -- cgit 1.5.1