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