docs: update calendar and link releases notes for 20.1.6
[mesa.git] / README.rst
1 `Mesa <https://mesa3d.org>`_ - The 3D Graphics Library
2 ======================================================
3
4
5 Source
6 ------
7
8 This repository lives at https://gitlab.freedesktop.org/mesa/mesa.
9 Other repositories are likely forks, and code found there is not supported.
10
11
12 Build & install
13 ---------------
14
15 You can find more information in our documentation (`docs/install.rst
16 <https://mesa3d.org/install.html>`_), but the recommended way is to use
17 Meson (`docs/meson.rst <https://mesa3d.org/meson.html>`_):
18
19 .. code-block:: sh
20
21 $ mkdir build
22 $ cd build
23 $ meson ..
24 $ sudo ninja install
25
26
27 Support
28 -------
29
30 Many Mesa devs hang on IRC; if you're not sure which channel is
31 appropriate, you should ask your question on `Freenode's #dri-devel
32 <irc://chat.freenode.net#dri-devel>`_, someone will redirect you if
33 necessary.
34 Remember that not everyone is in the same timezone as you, so it might
35 take a while before someone qualified sees your question.
36 To figure out who you're talking to, or which nick to ping for your
37 question, check out `Who's Who on IRC
38 <https://dri.freedesktop.org/wiki/WhosWho/>`_.
39
40 The next best option is to ask your question in an email to the
41 mailing lists: `mesa-dev\@lists.freedesktop.org
42 <https://lists.freedesktop.org/mailman/listinfo/mesa-dev>`_
43
44
45 Bug reports
46 -----------
47
48 If you think something isn't working properly, please file a bug report
49 (`docs/bugs.rst <https://mesa3d.org/bugs.html>`_).
50
51
52 Contributing
53 ------------
54
55 Contributions are welcome, and step-by-step instructions can be found in our
56 documentation (`docs/submittingpatches.rst
57 <https://mesa3d.org/submittingpatches.html>`_).
58
59 Note that Mesa uses gitlab for patches submission, review and discussions.