|
4 | 4 | community with contributors from around the world. Question, suggestion
|
5 | 5 | bug or patch? All those are most welcome via the channels below.</p>
|
6 | 6 |
|
7 |
| -<h2>Bugs / feature requests</h2> |
8 |
| - |
9 |
| -<p>Bugs and feature enhancements are tracked at <a href="https://github.com/DOMjudge/domjudge/issues">our Github project</a>. You may report a new issue there. |
10 |
| -Pull requests are also very welcome. |
11 |
| -If you have a <em>question</em> or you are unsure whether what you're seeing is |
12 |
| -a bug, please discuss it on <kbd> [email protected]</kbd> or |
13 |
| -<a href="chat">Slack</a> beforehand (see below).</p> |
14 |
| - |
15 |
| -<h2>Mailinglists</h2> |
16 |
| - |
17 |
| -<p>You are welcome to subscribe to our mailinglists:</p> |
18 |
| -<p> |
19 |
| -<dl> |
20 |
| -<dt>DOMjudge-announce</dt> |
21 |
| -<dd>This low-volume |
22 |
| -<a href="https://www.domjudge.org/mailman/listinfo/domjudge-announce">announcement list</a> |
23 |
| -is used for sending announcements about new releases and other important |
24 |
| -news.</dd> |
25 |
| -<dt>DOMjudge-devel</dt> |
26 |
| -<dd>The |
27 |
| -<a href="https://www.domjudge.org/mailman/listinfo/domjudge-devel">development mailinglist</a> |
28 |
| -is used for discussions on development, but is also used for asking general |
29 |
| -questions on using and installing DOMjudge.</dd> |
30 |
| -</dl> |
31 |
| - |
32 |
| -<p>Note that only the DOMjudge-devel list can be posted to, and only by |
33 |
| -list members (to prevent spam).</p> |
34 |
| - |
35 |
| -<h2>Snapshots</h2> |
| 7 | +<h2>Source code</h2> |
36 | 8 |
|
37 |
| -<p>We produce nightly snapshots of the latest DOMjudge sources (the |
38 |
| -<code>master</code> branch from the main git repository). These can be found in |
39 |
| -<a href="/snapshot/">the snapshot directory</a>. Note that our repository |
40 |
| -contains code that might be experimental, buggy or subject to change. Use |
41 |
| -at your own risk.</p> |
| 9 | +<p>The DOMjudge sources are maintained |
| 10 | +<a href="https://github.com/DOMjudge/">on GitHub</a>. |
| 11 | +You can get the <a href="https://github.com/DOMjudge/domjudge">main repository</a> |
| 12 | +with the following command: |
42 | 13 |
|
43 |
| -<h2>Source code</h2> |
| 14 | +<pre>git clone https://github.com/DOMjudge/domjudge.git</pre> |
44 | 15 |
|
45 |
| -<p>The DOMjudge sources are maintained in Git, in four separate |
46 |
| -<a href="https://github.com/DOMjudge">repositories</a>:</p> |
| 16 | +<p>Refer to the <a href="/snapshot/manual/develop.html">manual on developer information</a> |
| 17 | +for how to run DOMjudge from git sources.</p> |
47 | 18 |
|
48 |
| -<dl> |
49 |
| -<dt>DOMjudge</dt> |
50 |
| -<dd>The main repository that contains the source code of the system itself. |
51 |
| - <ul> |
52 |
| - <li>Public git repository: <kbd>https://github.com/DOMjudge/domjudge.git</kbd></li> |
53 |
| - <li>Public web interface: <a href="https://github.com/DOMjudge/domjudge">github</a>, <a href="https://www.domjudge.org/gitweb?p=domjudge.git">gitweb</a></li> |
54 |
| - </ul> |
55 |
| -</dd> |
56 |
| -<dt>DOMjudge-packaging</dt> |
57 |
| -<dd>Contains packaging for various distributions. |
58 |
| - <ul> |
59 |
| - <li>Public git repository: <kbd>https://github.com/DOMjudge/domjudge-packaging.git</kbd></li> |
60 |
| - <li>Public web interface: <a href="https://github.com/DOMjudge/domjudge-packaging">github</a>, <a href="https://www.domjudge.org/gitweb?p=domjudge-packaging.git">gitweb</a></li> |
61 |
| - </ul> |
62 |
| -</dd> |
63 |
| -<dt>DOMjudge-scripts</dt> |
64 |
| -<dd>Contains various developer helper scripts and the website. |
65 |
| - <ul> |
66 |
| - <li>Public git repository: <kbd>https://github.com/DOMjudge/domjudge-scripts.git</kbd></li> |
67 |
| - <li>Public web interface: <a href="https://github.com/DOMjudge/domjudge-scripts">github</a>, <a href="https://www.domjudge.org/gitweb?p=domjudge-scripts.git">gitweb</a></li> |
68 |
| - </ul> |
69 |
| -</dd> |
70 |
| -<dt>Checktestdata</dt> |
71 |
| -<dd>Contains checktestdata: a program to syntactically verify testdata. |
72 |
| - <ul> |
73 |
| - <li>Public git repository: <kbd>https://github.com/DOMjudge/checktestdata.git</kbd></li> |
74 |
| - <li>Public web interface: <a href="https://github.com/DOMjudge/checktestdata">github</a>, <a href="https://www.domjudge.org/gitweb?p=checktestdata.git">gitweb</a></li> |
75 |
| - </ul> |
76 |
| -</dd> |
77 |
| -</dl> |
| 19 | +<h2>Bugs / feature requests</h2> |
78 | 20 |
|
79 |
| -<p>You can create a local copy of these git repositories with the command |
80 |
| -(replace URL as desired):</p> |
| 21 | +<p>Bugs and feature enhancements are tracked at |
| 22 | +<a href="https://github.com/DOMjudge/domjudge/issues">our Github project</a>. |
| 23 | +You may report a new issue there. |
| 24 | +If you have a <em>question</em> or you are unsure whether what you're seeing is |
| 25 | +a bug, please discuss it on <kbd> [email protected]</kbd> or |
| 26 | +chat beforehand (see below).</p> |
81 | 27 |
|
82 |
| -<pre>git clone https://github.com/DOMjudge/domjudge.git</pre> |
| 28 | +<h2>Mailinglist and chat</h2> |
83 | 29 |
|
| 30 | +<p>You are welcome to subscribe to our |
| 31 | +<a href="https://www.domjudge.org/mailman/listinfo/domjudge-devel">development mailinglist</a> |
| 32 | +for discussions on development, but also for asking general |
| 33 | +questions on using and installing DOMjudge (you need to subscribe |
| 34 | +to the list before you can post). |
84 | 35 |
|
85 |
| -<h2>More information</h2> |
| 36 | +<p>Our <a href="chat">Slack workspace</a> is also a great place to ask about |
| 37 | +issues of discuss improvement ideas.</p> |
86 | 38 |
|
87 |
| -<p>Additional information can be found in the administrator's manual, |
88 |
| -especially the |
89 |
| -<a href="/snapshot/manual/develop.html">appendix with developer information</a>.</p> |
| 39 | +<h2>How to contribute</h2> |
90 | 40 |
|
91 |
| -<p>If you have any questions left, don't hesitate to ask at the <a href="https://www.domjudge.org/mailman/listinfo/domjudge-devel">DOMjudge-devel mailinglist</a>.</p> |
| 41 | +We welcome contributions of any kind from anyone. Please see our |
| 42 | +<a href="https://github.com/DOMjudge/domjudge/blob/master/CONTRIBUTING.md">CONTRIBUTING</a> |
| 43 | +document for hints and places to start. Submitting a pull request |
| 44 | +is the best way to propose a change or improvement to DOMjudge. |
| 45 | +Be sure to ask if anything is unclear. We're glad to help! |
92 | 46 |
|
93 | 47 | <!--#include virtual="/footer.shtml" -->
|
0 commit comments