Fix cookbook warnings and formatting

Summary

Follow-up to !316 (merged)

Fix a few warnings and improve rendering of some applications documentation. Also make sure ram parameter is third from last.

Rationale

More beautiful cookbook!

Copyright

The copyright owner is CNES and has signed the ORFEO ToolBox Contributor License Agreement.

---

Check before merging:

• All discussions are resolved
• At least 2 votes from core developers, no vote.
• The feature branch is (reasonably) up-to-date with the base branch
• Dashboard is green
• Copyright owner has signed the ORFEO ToolBox Contributor License Agreement

Documentation/Cookbook/Scripts/otb_warnings.py

@@ -18,17 +18,6 @@ def parameter_warnings(app_warn, app, key):
     if "." in name:
         warn("name contains a special character (.)")
 
-    # disabled because there are so many for now
-    #if description == "":
-        #warn("missing description")
-
-    # disabled because there are so many for now
-    #if len(description) > 0 and description[-1] != ".":
-        #warn("description does not end with a period")
-
-    if len(description) > 0 and " :" in description:
-        warn("description has a space before a colon")
-
 def application_documentation_warnings(app):
     "Emit warnings about application documentation"
 
@@ -38,16 +27,9 @@ def application_documentation_warnings(app):
     description = app.GetDescription()
     longdescription = app.GetDocLongDescription()
 
-    # disable because there are so many for now
-    #if not longdescription[-1] == ".":
-        #warn("Application Long Description does not end with a period (.)")
-
     if re.search("\\n [a-zA-Z]", longdescription):
         warn("Application Long Description contains '\\n ' pattern (usually not intended)")
 
-    if " :" in longdescription:
-        warn("Application Long Description has a space before a colon")
-
     if app.GetNumberOfExamples() == 0:
         warn("Application has no examples")