kaslo/synapse
1
0
Fork 0
Code Wiki Activity

deploy: 54aa7047eb

Browse Source
This commit is contained in:
Azrenbeth
2021-08-27 14:19:43 +00:00
parent f7919db5f5
commit 24d8c35592
7 changed files with 42 additions and 218 deletions
Download Patch File Download Diff File Expand all files Collapse all files

62
develop/development/contributing_guide.html
View File

@@ -189,43 +189,6 @@
<h1 id="contributing"><a class="header" href="#contributing">Contributing</a></h1>
<p>Welcome to Synapse</p>
<p>This document aims to get you started with contributing to this repo! </p>
<ul>
<li><a href="#1-who-can-contribute-to-synapse">1. Who can contribute to Synapse?</a></li>
<li><a href="#2-what-do-i-need">2. What do I need?</a></li>
<li><a href="#3-get-the-source">3. Get the source.</a></li>
<li><a href="#4-install-the-dependencies">4. Install the dependencies</a>
<ul>
<li><a href="#under-unix-macos-linux-bsd-">Under Unix (macOS, Linux, BSD, ...)</a></li>
<li><a href="#under-windows">Under Windows</a></li>
</ul>
</li>
<li><a href="#5-get-in-touch">5. Get in touch.</a></li>
<li><a href="#6-pick-an-issue">6. Pick an issue.</a></li>
<li><a href="#7-turn-coffee-and-documentation-into-code-and-documentation">7. Turn coffee and documentation into code and documentation!</a></li>
<li><a href="#8-test-test-test">8. Test, test, test!</a>
<ul>
<li><a href="#run-the-linters">Run the linters.</a></li>
<li><a href="#run-the-unit-tests-twisted-trial">Run the unit tests.</a></li>
<li><a href="#run-the-integration-tests-sytest">Run the integration tests (SyTest).</a></li>
<li><a href="#run-the-integration-tests-complement">Run the integration tests (Complement).</a></li>
</ul>
</li>
<li><a href="#9-submit-your-patch">9. Submit your patch.</a>
<ul>
<li><a href="#changelog">Changelog</a>
<ul>
<li><a href="#how-do-i-know-what-to-call-the-changelog-file-before-i-create-the-pr">How do I know what to call the changelog file before I create the PR?</a></li>
<li><a href="#debian-changelog">Debian changelog</a></li>
</ul>
</li>
<li><a href="#sign-off">Sign off</a></li>
</ul>
</li>
<li><a href="#10-turn-feedback-into-better-code">10. Turn feedback into better code.</a></li>
<li><a href="#11-find-a-new-issue">11. Find a new issue.</a></li>
<li><a href="#notes-for-maintainers-on-merging-prs-etc">Notes for maintainers on merging PRs etc</a></li>
<li><a href="#conclusion">Conclusion</a></li>
</ul>
<h1 id="1-who-can-contribute-to-synapse"><a class="header" href="#1-who-can-contribute-to-synapse">1. Who can contribute to Synapse?</a></h1>
<p>Everyone is welcome to contribute code to <a href="https://github.com/matrix-org">matrix.org
projects</a>, 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
<a href="LICENSE">LICENSE</a>).</p>
<a href="https://github.com/matrix-org/synapse/blob/develop/LICENSE">LICENSE</a>).</p>
<h1 id="2-what-do-i-need"><a class="header" href="#2-what-do-i-need">2. What do I need?</a></h1>
<p>The code of Synapse is written in Python 3. To do pretty much anything, you'll need <a href="https://wiki.python.org/moin/BeginnersGuide/Download">a recent version of Python 3</a>.</p>
<p>The source code of Synapse is hosted on GitHub. You will also need <a href="https://github.com/git-guides/install-git">a recent version of git</a>.</p>
@@ -268,16 +231,19 @@ pip install tox
<p>Fix your favorite problem or perhaps find a <a href="https://github.com/matrix-org/synapse/issues?q=is%3Aopen+is%3Aissue+label%3A%22Good+First+Issue%22">Good First Issue</a>
to work on.</p>
<h1 id="7-turn-coffee-and-documentation-into-code-and-documentation"><a class="header" href="#7-turn-coffee-and-documentation-into-code-and-documentation">7. Turn coffee and documentation into code and documentation!</a></h1>
<p>Synapse's code style is documented <a href="docs/code_style.html">here</a>. Please follow
it, including the conventions for the <a href="docs/code_style.html#configuration-file-format">sample configuration
file</a>.</p>
<p>There is a growing amount of documentation located in the <a href="docs">docs</a>
<p>Synapse's code style is documented
<a href="https://matrix-org.github.io/synapse/develop/code_style.html">here</a>.
Please follow it, including the conventions for the
<a href="https://matrix-org.github.io/synapse/develop/code_style.html#configuration-file-format">sample configuration file</a>.</p>
<p>There is a growing amount of documentation located in the
<a href="https://github.com/matrix-org/synapse/tree/develop/docs">docs</a>
directory. This documentation is intended primarily for sysadmins running their
own Synapse instance, as well as developers interacting externally with
Synapse. <a href="docs/dev">docs/dev</a> exists primarily to house documentation for
Synapse developers. <a href="docs/admin_api">docs/admin_api</a> houses documentation
regarding Synapse's Admin API, which is used mostly by sysadmins and external
service developers.</p>
own Synapse instance, as well as developers interacting externally with Synapse.
<a href="https://github.com/matrix-org/synapse/tree/develop/docs/development">docs/development</a>
exists primarily to house documentation for Synapse developers.
<a href="https://github.com/matrix-org/synapse/tree/develop/docs/admin_api">docs/admin_api</a>
houses documentation regarding Synapse's Admin API, which is used mostly by sysadmins
and external service developers.</p>
<p>If you add new files added to either of these folders, please use <a href="https://guides.github.com/features/mastering-markdown/">GitHub-Flavoured
Markdown</a>.</p>
<p>Some documentation also exists in <a href="https://github.com/matrix-org/synapse/wiki">Synapse's GitHub
@@ -521,7 +487,7 @@ flag to <code>git commit</code>, which uses the name and email set in your
<p>By now, you know the drill!</p>
<h1 id="notes-for-maintainers-on-merging-prs-etc"><a class="header" href="#notes-for-maintainers-on-merging-prs-etc">Notes for maintainers on merging PRs etc</a></h1>
<p>There are some notes for those with commit access to the project on how we
manage git <a href="docs/development/git.html">here</a>.</p>
manage git <a href="https://matrix-org.github.io/synapse/develop/development/git.html">here</a>.</p>
<h1 id="conclusion"><a class="header" href="#conclusion">Conclusion</a></h1>
<p>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