020: warnings, tips

Author: leogermond

courses/fundamentals_of_ada/020_declarations/01-introduction.rst

@@ -40,7 +40,8 @@ Declarations
 
     - ``N`` is usually an :dfn:`identifier`
 
-* Declaration **must precede** use
+.. warning:: Declaration **must precede** use
+
 * **Some** implicit declarations
 
     - **Standard** types and operations

courses/fundamentals_of_ada/020_declarations/02-identifiers_and_comments.rst

@@ -37,7 +37,7 @@ Identifiers
    - `SpacePerson` |equivalent| `SPACEPERSON`
    - ...but **different** from `Space_Person`
 
-* Reserved words are **forbidden**
+.. warning:: Reserved words are **forbidden**
 
 ----------------
 Reserved Words

courses/fundamentals_of_ada/020_declarations/03-literals.rst

@@ -34,7 +34,8 @@ Decimal Numeric Literals
         numeral [.numeral] E [+numeral|-numeral]
       numeral ::= digit {['_'] digit}
 
-* Underscore is not significant
+.. tip:: Underscore is **not** significant and used for grouping
+
 * **E** (exponent) must always be integer
 * Examples
 

courses/fundamentals_of_ada/020_declarations/05-universal_types.rst

@@ -34,12 +34,12 @@ Numeric Literals Are Universally Typed
 
 * Compiler handles typing
 
-   - No bugs with precision
+.. tip:: No bugs with precision
 
-  .. code:: Ada
+.. code:: Ada
 
-     X : Unsigned_Long := 0;
-     Y : Unsigned_Short := 0;
+   X : Unsigned_Long := 0;
+   Y : Unsigned_Short := 0;
 
 ----------------------------------------
 Literals Must Match "Class" of Context

courses/fundamentals_of_ada/020_declarations/06-named_numbers.rst

@@ -51,12 +51,13 @@ Named Number Benefit
 * Evaluation at **compile time**
 
     - As if **used directly** in the code
-    - **Perfect** accuracy
 
-  .. code:: Ada
+.. tip:: They have **perfect** accuracy
 
-    Named_Number   : constant :=       1.0 / 3.0;
-    Typed_Constant : constant Float := 1.0 / 3.0;
+.. code:: Ada
+
+   Named_Number   : constant :=       1.0 / 3.0;
+   Typed_Constant : constant Float := 1.0 / 3.0;
 
 .. container:: latex_environment footnotesize
 

courses/fundamentals_of_ada/020_declarations/07-scope_and_visibility.rst

@@ -61,9 +61,8 @@ Scope and "Lifetime"
 ----------------------
 
 * Object in scope |rightarrow| exists
-* No *scoping* keywords
 
-    - C's :c:`static`, :c:`auto` etc...
+.. warning:: No *scoping* keywords (C's :c:`static`, :c:`auto` etc...)
 
 .. image:: block_scope_example.jpeg
     :height: 50%
@@ -101,9 +100,11 @@ Overcoming Hiding
 
    - Needs named scope
 
-* Homographs are a *code smell*
+.. warning::
 
-    - May need **refactoring**...
+    * Homographs are a *code smell*
+
+        - May need **refactoring**...
 
 .. code:: Ada