fixup docs

Author: amykyta3

docs/best-practices.rst

@@ -103,6 +103,8 @@ With default assignments:
 
 .. tip::
 
-    Use default assignments in the most local lexical scope possible.
+    Use default assignments in the most local lexical scope that is appropriate.
     This improves readability, and prevents the assignment from affecting
     something you didn't intend.
+
+    Avoid using default assignments in the root namespace.

docs/for-devs/importer-plugin.rst

@@ -62,7 +62,7 @@ Plugin Discovery
 There are two ways PeakRDL can discover your plugin.
 
 Via Entry Point
----------------
+^^^^^^^^^^^^^^^
 
 The PeakRDL command line tool automatically discovers importers by scanning the
 entry points that installed packages advertise.

docs/style-guide.rst

@@ -208,6 +208,29 @@ Parameters and Verilog-style macros are uppercase
 -------------------------------------------------
 Constants should be in ALL_CAPS
 
+|:thumbsup:|
+
+.. code:: systemrdl
+
+    field my_field #(
+        longint unsigned MY_PARAM = 1,
+        longint unsigned OTHER_PARAM = 2
+    ){
+        // ...
+    };
+
+
+|:thumbsdown:|
+
+.. code:: systemrdl
+
+    field my_field #(
+        longint unsigned my_param = 1,
+        longint unsigned other_param = 2
+    ){
+        // ...
+    };
+
 
 Long descriptions
 -----------------