libcamera/Documentation/contributing.rst
Laurent Pinchart 53c4d4c34f Documentation: Generate source code documentation using Doxygen
Extend the documentation build system to automatically generate
documentation from source code using Doxygen. This is currently separate
from the sphinx documentation, and should be integrated using the
breathe (and possibly exhale) extensions.

As the Documentation/meson.build file needs to reference the variables
holding the source files, move the Documentation directory to the end of
the subdirs() in the top-level meson.build.

Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
2018-12-12 20:45:24 +02:00

46 lines
1.5 KiB
ReStructuredText

Contributing
============
libcamera is developed as a free software project and welcomes contributors.
Whether you would like to help with coding, documentation, testing, proposing
new features, or just discussing the project with the community, you can join
our official public communication channels, or simply check out the code.
Mailing List
------------
We use a public mailing list as our main means of communication. You can find
subscription information and the messages archive on the `libcamera-devel`_
list information page.
.. _libcamera-devel: https://lists.libcamera.org/listinfo/libcamera-devel
IRC Channel
-----------
For informal and real time discussions, our IRC channel on Freenode is open to
the public. Point your IRC client to #libcamera to say hello, or use the `WebChat`_.
.. _WebChat: https://webchat.freenode.net/?channels=%23libcamera&uio=d4
Source Code
-----------
libcamera is in early stages of development, and no releases are available yet.
The source code is available from the project's git tree, hosted by LinuxTV.
$ git clone git://linuxtv.org/libcamera.git
Documentation
-------------
Project documentation is created using `Sphinx`_. Source level documentation
uses `Doxygen`_. Please make sure to document all code during development.
Sphinx integration with Doxygen is planned, likely using `Breathe`_ and
`Exhale`_.
.. _Sphinx: http://www.sphinx-doc.org
.. _Doxygen: http://www.doxygen.nl
.. _Breathe: https://breathe.readthedocs.io/en/latest/
.. _Exhale: https://exhale.readthedocs.io/en/latest/