mirror of
https://github.com/element-hq/synapse
synced 2024-08-19 01:00:54 +00:00
deploy: e564bdd127
This commit is contained in:
parent
1c2a1a1355
commit
e34143bd99
6 changed files with 247 additions and 4 deletions
|
@ -221,7 +221,7 @@ pip install tox
|
|||
<h2 id="under-windows"><a class="header" href="#under-windows">Under Windows</a></h2>
|
||||
<p>TBD</p>
|
||||
<h1 id="5-get-in-touch"><a class="header" href="#5-get-in-touch">5. Get in touch.</a></h1>
|
||||
<p>Join our developer community on Matrix: #synapse-dev:matrix.org !</p>
|
||||
<p>Join our developer community on Matrix: <a href="https://matrix.to/#/#synapse-dev:matrix.org">#synapse-dev:matrix.org</a>!</p>
|
||||
<h1 id="6-pick-an-issue"><a class="header" href="#6-pick-an-issue">6. Pick an issue.</a></h1>
|
||||
<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>
|
||||
|
|
|
@ -186,6 +186,87 @@
|
|||
<p>Welcome to the documentation repository for Synapse, a
|
||||
<a href="https://matrix.org">Matrix</a> homeserver implementation developed by the matrix.org core
|
||||
team.</p>
|
||||
<h2 id="installing-and-using-synapse"><a class="header" href="#installing-and-using-synapse">Installing and using Synapse</a></h2>
|
||||
<p>This documentation covers topics for <strong>installation</strong>, <strong>configuration</strong> and
|
||||
<strong>maintainence</strong> of your Synapse process:</p>
|
||||
<ul>
|
||||
<li>
|
||||
<p>Learn how to <a href="setup/installation.html">install</a> and
|
||||
<a href="usage/configuration/index.html">configure</a> your own instance, perhaps with <a href="usage/configuration/user_authentication/index.html">Single
|
||||
Sign-On</a>.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>See how to <a href="upgrade.html">upgrade</a> between Synapse versions.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Administer your instance using the <a href="usage/administration/admin_api/index.html">Admin
|
||||
API</a>, installing <a href="modules/index.html">pluggable
|
||||
modules</a>, or by accessing the <a href="manhole.html">manhole</a>.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Learn how to <a href="usage/administration/request_log.html">read log lines</a>, configure
|
||||
<a href="usage/configuration/logging_sample_config.html">logging</a> or set up <a href="structured_logging.html">structured
|
||||
logging</a>.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Scale Synapse through additional <a href="workers.html">worker processes</a>.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Set up <a href="metrics-howto.html">monitoring and metrics</a> to keep an eye on your
|
||||
Synapse instance's performance.</p>
|
||||
</li>
|
||||
</ul>
|
||||
<h2 id="developing-on-synapse"><a class="header" href="#developing-on-synapse">Developing on Synapse</a></h2>
|
||||
<p>Contributions are welcome! Synapse is primarily written in
|
||||
<a href="https://python.org">Python</a>. As a developer, you may be interested in the
|
||||
following documentation:</p>
|
||||
<ul>
|
||||
<li>
|
||||
<p>Read the <a href="development/contributing_guide.html">Contributing Guide</a>. It is meant
|
||||
to walk new contributors through the process of developing and submitting a
|
||||
change to the Synapse codebase (which is <a href="https://github.com/matrix-org/synapse">hosted on
|
||||
GitHub</a>).</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Set up your <a href="development/contributing_guide.html#2-what-do-i-need">development
|
||||
environment</a>, then learn
|
||||
how to <a href="development/contributing_guide.html#run-the-linters">lint</a> and
|
||||
<a href="development/contributing_guide.html#8-test-test-test">test</a> your code.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Look at <a href="https://github.com/matrix-org/synapse/issues">the issue tracker</a> for
|
||||
bugs to fix or features to add. If you're new, it may be best to start with
|
||||
those labeled <a href="https://github.com/matrix-org/synapse/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22">good first
|
||||
issue</a>.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Understand <a href="development/internal_documentation/index.html">how Synapse is
|
||||
built</a>, how to <a href="development/database_schema.html">migrate
|
||||
database schemas</a>, learn about
|
||||
<a href="federate.html">federation</a> and how to <a href="federate.html#running-a-demo-federation-of-synapses">set up a local
|
||||
federation</a> for development.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>We like to keep our <code>git</code> history clean. <a href="development/git.html">Learn</a> how to
|
||||
do so!</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>And finally, contribute to this documentation! The source for which is
|
||||
<a href="https://github.com/matrix-org/synapse/tree/develop/docs">located here</a>.</p>
|
||||
</li>
|
||||
</ul>
|
||||
<h2 id="donating-to-synapse-development"><a class="header" href="#donating-to-synapse-development">Donating to Synapse development</a></h2>
|
||||
<p>Want to help keep Synapse going but don't know how to code? Synapse is a
|
||||
<a href="https://matrix.org">Matrix.org Foundation</a> project. Consider becoming a
|
||||
supportor on <a href="https://liberapay.com/matrixdotorg">Liberapay</a>,
|
||||
<a href="https://patreon.com/matrixdotorg">Patreon</a> or through
|
||||
<a href="https://paypal.me/matrixdotorg">PayPal</a> via a one-time donation.</p>
|
||||
<p>If you are an organisation or enterprise and would like to sponsor development,
|
||||
reach out to us over email at: support (at) matrix.org</p>
|
||||
<h2 id="reporting-a-security-vulnerability"><a class="header" href="#reporting-a-security-vulnerability">Reporting a security vulnerability</a></h2>
|
||||
<p>If you've found a security issue in Synapse or any other Matrix.org Foundation
|
||||
project, please report it to us in accordance with our <a href="https://www.matrix.org/security-disclosure-policy/">Security Disclosure
|
||||
Policy</a>. Thank you!</p>
|
||||
|
||||
</main>
|
||||
|
||||
|
|
|
@ -184,6 +184,87 @@
|
|||
<p>Welcome to the documentation repository for Synapse, a
|
||||
<a href="https://matrix.org">Matrix</a> homeserver implementation developed by the matrix.org core
|
||||
team.</p>
|
||||
<h2 id="installing-and-using-synapse"><a class="header" href="#installing-and-using-synapse">Installing and using Synapse</a></h2>
|
||||
<p>This documentation covers topics for <strong>installation</strong>, <strong>configuration</strong> and
|
||||
<strong>maintainence</strong> of your Synapse process:</p>
|
||||
<ul>
|
||||
<li>
|
||||
<p>Learn how to <a href="setup/installation.html">install</a> and
|
||||
<a href="usage/configuration/index.html">configure</a> your own instance, perhaps with <a href="usage/configuration/user_authentication/index.html">Single
|
||||
Sign-On</a>.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>See how to <a href="upgrade.html">upgrade</a> between Synapse versions.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Administer your instance using the <a href="usage/administration/admin_api/index.html">Admin
|
||||
API</a>, installing <a href="modules/index.html">pluggable
|
||||
modules</a>, or by accessing the <a href="manhole.html">manhole</a>.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Learn how to <a href="usage/administration/request_log.html">read log lines</a>, configure
|
||||
<a href="usage/configuration/logging_sample_config.html">logging</a> or set up <a href="structured_logging.html">structured
|
||||
logging</a>.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Scale Synapse through additional <a href="workers.html">worker processes</a>.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Set up <a href="metrics-howto.html">monitoring and metrics</a> to keep an eye on your
|
||||
Synapse instance's performance.</p>
|
||||
</li>
|
||||
</ul>
|
||||
<h2 id="developing-on-synapse"><a class="header" href="#developing-on-synapse">Developing on Synapse</a></h2>
|
||||
<p>Contributions are welcome! Synapse is primarily written in
|
||||
<a href="https://python.org">Python</a>. As a developer, you may be interested in the
|
||||
following documentation:</p>
|
||||
<ul>
|
||||
<li>
|
||||
<p>Read the <a href="development/contributing_guide.html">Contributing Guide</a>. It is meant
|
||||
to walk new contributors through the process of developing and submitting a
|
||||
change to the Synapse codebase (which is <a href="https://github.com/matrix-org/synapse">hosted on
|
||||
GitHub</a>).</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Set up your <a href="development/contributing_guide.html#2-what-do-i-need">development
|
||||
environment</a>, then learn
|
||||
how to <a href="development/contributing_guide.html#run-the-linters">lint</a> and
|
||||
<a href="development/contributing_guide.html#8-test-test-test">test</a> your code.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Look at <a href="https://github.com/matrix-org/synapse/issues">the issue tracker</a> for
|
||||
bugs to fix or features to add. If you're new, it may be best to start with
|
||||
those labeled <a href="https://github.com/matrix-org/synapse/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22">good first
|
||||
issue</a>.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Understand <a href="development/internal_documentation/index.html">how Synapse is
|
||||
built</a>, how to <a href="development/database_schema.html">migrate
|
||||
database schemas</a>, learn about
|
||||
<a href="federate.html">federation</a> and how to <a href="federate.html#running-a-demo-federation-of-synapses">set up a local
|
||||
federation</a> for development.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>We like to keep our <code>git</code> history clean. <a href="development/git.html">Learn</a> how to
|
||||
do so!</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>And finally, contribute to this documentation! The source for which is
|
||||
<a href="https://github.com/matrix-org/synapse/tree/develop/docs">located here</a>.</p>
|
||||
</li>
|
||||
</ul>
|
||||
<h2 id="donating-to-synapse-development"><a class="header" href="#donating-to-synapse-development">Donating to Synapse development</a></h2>
|
||||
<p>Want to help keep Synapse going but don't know how to code? Synapse is a
|
||||
<a href="https://matrix.org">Matrix.org Foundation</a> project. Consider becoming a
|
||||
supportor on <a href="https://liberapay.com/matrixdotorg">Liberapay</a>,
|
||||
<a href="https://patreon.com/matrixdotorg">Patreon</a> or through
|
||||
<a href="https://paypal.me/matrixdotorg">PayPal</a> via a one-time donation.</p>
|
||||
<p>If you are an organisation or enterprise and would like to sponsor development,
|
||||
reach out to us over email at: support (at) matrix.org</p>
|
||||
<h2 id="reporting-a-security-vulnerability"><a class="header" href="#reporting-a-security-vulnerability">Reporting a security vulnerability</a></h2>
|
||||
<p>If you've found a security issue in Synapse or any other Matrix.org Foundation
|
||||
project, please report it to us in accordance with our <a href="https://www.matrix.org/security-disclosure-policy/">Security Disclosure
|
||||
Policy</a>. Thank you!</p>
|
||||
<div id="chapter_begin" style="break-before: page; page-break-before: always;"></div><h1 id="installation-instructions"><a class="header" href="#installation-instructions">Installation Instructions</a></h1>
|
||||
<h2 id="choosing-your-server-name"><a class="header" href="#choosing-your-server-name">Choosing your server name</a></h2>
|
||||
<p>It is important to choose the name for your server before you install Synapse,
|
||||
|
@ -11455,7 +11536,7 @@ pip install tox
|
|||
<h2 id="under-windows"><a class="header" href="#under-windows">Under Windows</a></h2>
|
||||
<p>TBD</p>
|
||||
<h1 id="5-get-in-touch"><a class="header" href="#5-get-in-touch">5. Get in touch.</a></h1>
|
||||
<p>Join our developer community on Matrix: #synapse-dev:matrix.org !</p>
|
||||
<p>Join our developer community on Matrix: <a href="https://matrix.to/#/#synapse-dev:matrix.org">#synapse-dev:matrix.org</a>!</p>
|
||||
<h1 id="6-pick-an-issue"><a class="header" href="#6-pick-an-issue">6. Pick an issue.</a></h1>
|
||||
<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>
|
||||
|
|
File diff suppressed because one or more lines are too long
File diff suppressed because one or more lines are too long
|
@ -186,6 +186,87 @@
|
|||
<p>Welcome to the documentation repository for Synapse, a
|
||||
<a href="https://matrix.org">Matrix</a> homeserver implementation developed by the matrix.org core
|
||||
team.</p>
|
||||
<h2 id="installing-and-using-synapse"><a class="header" href="#installing-and-using-synapse">Installing and using Synapse</a></h2>
|
||||
<p>This documentation covers topics for <strong>installation</strong>, <strong>configuration</strong> and
|
||||
<strong>maintainence</strong> of your Synapse process:</p>
|
||||
<ul>
|
||||
<li>
|
||||
<p>Learn how to <a href="setup/installation.html">install</a> and
|
||||
<a href="usage/configuration/index.html">configure</a> your own instance, perhaps with <a href="usage/configuration/user_authentication/index.html">Single
|
||||
Sign-On</a>.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>See how to <a href="upgrade.html">upgrade</a> between Synapse versions.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Administer your instance using the <a href="usage/administration/admin_api/index.html">Admin
|
||||
API</a>, installing <a href="modules/index.html">pluggable
|
||||
modules</a>, or by accessing the <a href="manhole.html">manhole</a>.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Learn how to <a href="usage/administration/request_log.html">read log lines</a>, configure
|
||||
<a href="usage/configuration/logging_sample_config.html">logging</a> or set up <a href="structured_logging.html">structured
|
||||
logging</a>.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Scale Synapse through additional <a href="workers.html">worker processes</a>.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Set up <a href="metrics-howto.html">monitoring and metrics</a> to keep an eye on your
|
||||
Synapse instance's performance.</p>
|
||||
</li>
|
||||
</ul>
|
||||
<h2 id="developing-on-synapse"><a class="header" href="#developing-on-synapse">Developing on Synapse</a></h2>
|
||||
<p>Contributions are welcome! Synapse is primarily written in
|
||||
<a href="https://python.org">Python</a>. As a developer, you may be interested in the
|
||||
following documentation:</p>
|
||||
<ul>
|
||||
<li>
|
||||
<p>Read the <a href="development/contributing_guide.html">Contributing Guide</a>. It is meant
|
||||
to walk new contributors through the process of developing and submitting a
|
||||
change to the Synapse codebase (which is <a href="https://github.com/matrix-org/synapse">hosted on
|
||||
GitHub</a>).</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Set up your <a href="development/contributing_guide.html#2-what-do-i-need">development
|
||||
environment</a>, then learn
|
||||
how to <a href="development/contributing_guide.html#run-the-linters">lint</a> and
|
||||
<a href="development/contributing_guide.html#8-test-test-test">test</a> your code.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Look at <a href="https://github.com/matrix-org/synapse/issues">the issue tracker</a> for
|
||||
bugs to fix or features to add. If you're new, it may be best to start with
|
||||
those labeled <a href="https://github.com/matrix-org/synapse/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22">good first
|
||||
issue</a>.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>Understand <a href="development/internal_documentation/index.html">how Synapse is
|
||||
built</a>, how to <a href="development/database_schema.html">migrate
|
||||
database schemas</a>, learn about
|
||||
<a href="federate.html">federation</a> and how to <a href="federate.html#running-a-demo-federation-of-synapses">set up a local
|
||||
federation</a> for development.</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>We like to keep our <code>git</code> history clean. <a href="development/git.html">Learn</a> how to
|
||||
do so!</p>
|
||||
</li>
|
||||
<li>
|
||||
<p>And finally, contribute to this documentation! The source for which is
|
||||
<a href="https://github.com/matrix-org/synapse/tree/develop/docs">located here</a>.</p>
|
||||
</li>
|
||||
</ul>
|
||||
<h2 id="donating-to-synapse-development"><a class="header" href="#donating-to-synapse-development">Donating to Synapse development</a></h2>
|
||||
<p>Want to help keep Synapse going but don't know how to code? Synapse is a
|
||||
<a href="https://matrix.org">Matrix.org Foundation</a> project. Consider becoming a
|
||||
supportor on <a href="https://liberapay.com/matrixdotorg">Liberapay</a>,
|
||||
<a href="https://patreon.com/matrixdotorg">Patreon</a> or through
|
||||
<a href="https://paypal.me/matrixdotorg">PayPal</a> via a one-time donation.</p>
|
||||
<p>If you are an organisation or enterprise and would like to sponsor development,
|
||||
reach out to us over email at: support (at) matrix.org</p>
|
||||
<h2 id="reporting-a-security-vulnerability"><a class="header" href="#reporting-a-security-vulnerability">Reporting a security vulnerability</a></h2>
|
||||
<p>If you've found a security issue in Synapse or any other Matrix.org Foundation
|
||||
project, please report it to us in accordance with our <a href="https://www.matrix.org/security-disclosure-policy/">Security Disclosure
|
||||
Policy</a>. Thank you!</p>
|
||||
|
||||
</main>
|
||||
|
||||
|
|
Loading…
Reference in a new issue