docs: update javadoc conventions to README.md

Author: tom-weelborg

README.md

@@ -84,6 +84,8 @@ The following are lists of conventions that either *should* be followed or *must
     - Constructors
     - `static` functions
     - Instance methods
+- Interfaces:
+  - Names must begin with `I` and continue in `PascalCase`
 - `static` Constants:
   - Names must be `SCREAMING_SNAKE_CASE`
 - Instance Attributes and Method Parameters:
@@ -119,4 +121,5 @@ The following are lists of conventions that either *should* be followed or *must
     - all `private` members of which the purpose is not obvious or the logic is difficult to comprehend
   - May be added to:
     - `public static` constants
-    - other `private` members
+    - other `private` members
+  - Should explain **what** the code does and maybe **why**, but never **how**