From 24d8c35592de2e310a6c9e15fce7f18dcddceea0 Mon Sep 17 00:00:00 2001 From: Azrenbeth Date: Fri, 27 Aug 2021 14:19:43 +0000 Subject: deploy: 54aa7047ebf0d2605e31bdd4933effc4eb63813b --- develop/development/contributing_guide.html | 62 +++++++---------------------- 1 file changed, 14 insertions(+), 48 deletions(-) (limited to 'develop/development/contributing_guide.html') diff --git a/develop/development/contributing_guide.html b/develop/development/contributing_guide.html index b48ad1b806..e676d7edb4 100644 --- a/develop/development/contributing_guide.html +++ b/develop/development/contributing_guide.html @@ -189,43 +189,6 @@

Contributing

Welcome to Synapse

This document aims to get you started with contributing to this repo!

-

1. Who can contribute to Synapse?

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).

+LICENSE).

2. What do I need?

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 tox

Fix your favorite problem or perhaps find a Good First Issue to work on.

7. Turn coffee and documentation into code and documentation!

-

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 git commit, which uses the name and email set in your

By now, you know the drill!

Notes for maintainers on merging PRs etc

There are some notes for those with commit access to the project on how we -manage git here.

+manage git here.

Conclusion

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