Scaffold out the macros chapter to section level (x.y) (#61)

Author: PLeVasseur

src/coding-guidelines/macros.rst

@@ -5,3 +5,213 @@
 
 Macros
 ======
+
+.. guideline:: Shall not use Declarative Macros
+   :id: gui_h0uG1C9ZjryA
+   :category: mandatory
+   :status: draft
+   :release: todo
+   :fls: fls_xa7lp0zg1ol2
+   :decidability: decidable
+   :scope: system
+   :tags: reduce-human-error
+
+   Description of the guideline goes here.
+
+   .. rationale::
+      :id: rat_U3AEUPyaUhcb
+      :status: draft
+
+      Explanation of why this guideline is important.
+
+   .. non_compliant_example::
+      :id: non_compl_ex_Gb4zimei8cNI
+      :status: draft
+
+      Explanation of code example.
+
+      .. code-block:: rust
+
+        fn example_function() {
+            // Non-compliant implementation
+        }
+
+   .. compliant_example::
+      :id: compl_ex_Pw7YCh4Iv47Z
+      :status: draft
+
+      Explanation of code example
+
+      .. code-block:: rust
+
+        fn example_function() {
+            // Compliant implementation
+        }
+
+.. guideline:: Shall not use Procedural Macros
+   :id: gui_m6BKTDzO2rdL
+   :category: mandatory
+   :status: draft
+   :release: todo
+   :fls: fls_wn1i6hzg2ff7
+   :decidability: decidable
+   :scope: system
+   :tags: reduce-human-error
+
+   Description of the guideline goes here.
+
+   .. rationale::
+      :id: rat_kAcNBmDhJ5W8
+      :status: draft
+
+      Explanation of why this guideline is important.
+
+   .. non_compliant_example::
+      :id: non_compl_ex_xhIwlJPZYbVb
+      :status: draft
+
+      Explanation of code example.
+
+      .. code-block:: rust
+
+        fn example_function() {
+            // Non-compliant implementation
+        }
+
+   .. compliant_example::
+      :id: compl_ex_JxmIfJ7plkEf
+      :status: draft
+
+      Explanation of code example.
+
+      .. code-block:: rust
+
+        fn example_function() {
+            // Compliant implementation
+        }
+
+.. guideline:: Shall not invoke macros
+   :id: gui_a1mHfjgKk4Xr
+   :category: mandatory
+   :status: draft
+   :release: todo
+   :fls: fls_vnvt40pa48n8
+   :decidability: decidable
+   :scope: system
+   :tags: reduce-human-error
+
+   Description of the guideline goes here.
+
+   .. rationale::
+      :id: rat_62mSorNF05kD
+      :status: draft
+
+      Explanation of why this guideline is important.
+
+   .. non_compliant_example::
+      :id: non_compl_ex_hP5KLhqQfDcd
+      :status: draft
+
+      Explanation of code example.
+
+      .. code-block:: rust
+
+        fn example_function() {
+            // Non-compliant implementation
+        }
+
+   .. compliant_example::
+      :id: compl_ex_ti7GWHCOhUvT
+      :status: draft
+
+      Explanation of code example.
+
+      .. code-block:: rust
+
+        fn example_function() {
+            // Compliant implementation
+        }
+
+.. guideline:: Shall not write code that expands macros
+   :id: gui_uuDOArzyO3Qw
+   :category: mandatory
+   :status: draft
+   :release: todo
+   :fls: fls_wjldgtio5o75
+   :decidability: decidable
+   :scope: system
+   :tags: reduce-human-error
+
+   Description of the guideline goes here.
+
+   .. rationale::
+      :id: rat_dNgSvC0SZ3JJ
+      :status: draft
+
+      Explanation of why this guideline is important.
+
+   .. non_compliant_example::
+      :id: non_compl_ex_g9j8shyGM2Rh
+      :status: draft
+
+      Explanation of code example.
+
+      .. code-block:: rust
+
+        fn example_function() {
+            // Non-compliant implementation
+        }
+
+   .. compliant_example::
+      :id: compl_ex_cFPg6y7upNdl
+      :status: draft
+
+      Explanation of code example.
+
+      .. code-block:: rust
+
+        fn example_function() {
+            // Compliant implementation
+        }
+
+.. guideline:: Shall ensure complete hygiene of macros
+   :id: gui_8hs33nyp0ipX
+   :category: mandatory
+   :status: draft
+   :release: todo
+   :fls: fls_xlfo7di0gsqz
+   :decidability: decidable
+   :scope: system
+   :tags: reduce-human-error
+
+   Description of the guideline goes here.
+
+   .. rationale::
+      :id: rat_e9iS187skbHH
+      :status: draft
+
+      Explanation of why this guideline is important.
+
+   .. non_compliant_example::
+      :id: non_compl_ex_lRt4LBen6Lkc
+      :status: draft
+
+      Explanation of code example.
+
+      .. code-block:: rust
+
+        fn example_function() {
+            // Non-compliant implementation
+        }
+
+   .. compliant_example::
+      :id: compl_ex_GLP05s9c1g8N
+      :status: draft
+
+      Explanation of code example.
+
+      .. code-block:: rust
+
+        fn example_function() {
+            // Compliant implementation
+        }