From c60069241f5ebd7c3a024435171efc58f3d01522 Mon Sep 17 00:00:00 2001 From: Kieran Bingham Date: Tue, 20 Nov 2018 08:18:42 -0800 Subject: Documentation: Introduce sphinx documentation MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Utilise sphinx-build to generate documentation in HTML form, and populate with some initial content. An initial conf.py is generated from sphinx-quickstart and answering initial questions. Reviewed-by: Niklas Söderlund Signed-off-by: Kieran Bingham --- Documentation/contributing.rst | 46 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 46 insertions(+) create mode 100644 Documentation/contributing.rst (limited to 'Documentation/contributing.rst') diff --git a/Documentation/contributing.rst b/Documentation/contributing.rst new file mode 100644 index 00000000..dd6f5efa --- /dev/null +++ b/Documentation/contributing.rst @@ -0,0 +1,46 @@ +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 +is currently planned to utilise Doxygen integration. Please use this in your +development. + +Sphinx integration with Doxygen will be with either `Breathe`_ or `Exhale`_ +depending upon which system works best + +.. _Sphinx: http://www.sphinx-doc.org +.. _Breathe: https://breathe.readthedocs.io/en/latest/ +.. _Exhale: https://exhale.readthedocs.io/en/latest/ -- cgit v1.2.1