doc/devguide: create basic layout

Issue: #3343

doc/devguide/Makefile.am

@@ -2,9 +2,24 @@ EXTRA_DIST = \
 	conf.py \
 	_static \
 	index.rst \
-	code-submission-process.rst \
+	extending/detect/index.rst \
-	code-style.rst \
+	extending/decoder/index.rst \
-	app-layer
+	extending/index.rst \
+	extending/app-layer/index.rst \
+	extending/app-layer/parser.rst \
+	extending/capture/index.rst \
+	extending/output/index.rst \
+	internals/engines/index.rst \
+	internals/threading/index.rst \
+	internals/index.rst \
+	internals/pipeline/index.rst \
+	internals/datastructs/index.rst \
+	codebase/unittests.rst \
+	codebase/index.rst \
+	codebase/code-style.rst \
+	codebase/contributing/code-submission-process.rst \
+	codebase/contributing/index.rst \
+	codebase/fuzz-testing.rst
 
 if HAVE_SPHINXBUILD
 

doc/devguide/codebase/contributing/index.rst

@@ -0,0 +1,7 @@
+Contributing
+============
+
+.. toctree::
+   :maxdepth: 2
+
+   code-submission-process

doc/devguide/codebase/fuzz-testing.rst

@@ -0,0 +1,31 @@
+Fuzz Testing
+============
+
+To enable fuzz targets compilation, add `--enable-fuzztargets` to configure.
+
+.. note:: This changes various parts of Suricata making the `suricata` binary
+          unsafe for production use.
+
+The targets can be used with libFuzzer, AFL and other fuzz platforms.
+
+
+Running the Fuzzers
+-------------------
+
+TODO. For now see src/tests/fuzz/README
+
+Reproducing issues
+^^^^^^^^^^^^^^^^^^
+
+
+Extending Coverage
+------------------
+
+Adding Fuzz Targets
+-------------------
+
+
+Oss-Fuzz
+--------
+
+Suricata is continuesly fuzz tested in Oss-Fuzz. See https://github.com/google/oss-fuzz/tree/master/projects/suricata

doc/devguide/codebase/index.rst

@@ -0,0 +1,10 @@
+Working with the Codebase
+=========================
+
+.. toctree::
+   :maxdepth: 2
+
+   contributing/index.rst
+   code-style
+   unittests
+   fuzz-testing

doc/devguide/codebase/unittests.rst

@@ -0,0 +1,12 @@
+Unittests
+=========
+
+Unittests are a great way to create tests that can check the internal state
+of parsers, structures and other objects.
+
+Tests should:
+
+- use FAIL/PASS macros
+- be deterministic
+- not leak memory on PASS
+- not use conditions

doc/devguide/extending/capture/index.rst

@@ -0,0 +1,2 @@
+Packet Capture
+==============

doc/devguide/extending/decoder/index.rst

@@ -0,0 +1,2 @@
+Packet Decoder
+==============

doc/devguide/extending/detect/index.rst

@@ -0,0 +1,2 @@
+Detection
+=========

doc/devguide/extending/index.rst

@@ -0,0 +1,11 @@
+Extending Suricata
+==================
+
+.. toctree::
+   :maxdepth: 2
+
+   capture/index.rst
+   decoder/index.rst
+   app-layer/index.rst
+   detect/index.rst
+   output/index.rst

doc/devguide/extending/output/index.rst

@@ -0,0 +1,7 @@
+Output
+======
+
+Introduction
+------------
+
+Extending Suricata's alert and event output.

doc/devguide/index.rst

@@ -5,6 +5,6 @@ Suricata Developer Guide
    :numbered:
    :maxdepth: 2
 
-   code-submission-process
+   codebase/index.rst
-   code-style
+   internals/index.rst
-   app-layer/index.rst
+   extending/index.rst

doc/devguide/internals/datastructs/index.rst

@@ -0,0 +1,9 @@
+Important Data Structures
+=========================
+
+Introduction
+------------
+
+This section explains the most important Suricata Data structures.
+
+For a complete overview, see the doxygen: https://doxygen.openinfosecfoundation.org

doc/devguide/internals/engines/index.rst

@@ -0,0 +1,11 @@
+Engines
+=======
+
+Flow
+----
+
+Stream
+------
+
+Defrag
+------

doc/devguide/internals/index.rst

@@ -0,0 +1,10 @@
+Suricata Internals
+==================
+
+.. toctree::
+   :maxdepth: 2
+
+   pipeline/index.rst
+   threading/index.rst
+   datastructs/index.rst
+   engines/index.rst

doc/devguide/internals/pipeline/index.rst

@@ -0,0 +1,2 @@
+Packet Pipeline
+===============

doc/devguide/internals/threading/index.rst

@@ -0,0 +1,2 @@
+Threading
+=========