From a33a310e3835201a1eb2b0dbd220e36a3598937a Mon Sep 17 00:00:00 2001
From: Martin Schroschk <martin.schroschk@tu-dresden.de>
Date: Fri, 23 Dec 2022 07:41:13 +0100
Subject: [PATCH] Resolve issue #407 by adding information about optimization
 flag

* Some line adjustment
---
 .../software/software_development_overview.md | 40 +++++++++----------
 1 file changed, 20 insertions(+), 20 deletions(-)

diff --git a/doc.zih.tu-dresden.de/docs/software/software_development_overview.md b/doc.zih.tu-dresden.de/docs/software/software_development_overview.md
index 04471fb13..9b610b7a1 100644
--- a/doc.zih.tu-dresden.de/docs/software/software_development_overview.md
+++ b/doc.zih.tu-dresden.de/docs/software/software_development_overview.md
@@ -15,26 +15,26 @@ It will tell you:
     - [Using debuggers](debuggers.md)
 - [How to investigate the performance and efficiency of your code](performance_engineering_overview.md)
 
-Some hints that are helpful:
 
-- Stick to standards wherever possible, e.g. use the `-std` flag
-  for GNU and Intel C/C++ compilers. Computers are short living
-  creatures, migrating between platforms can be painful. In addition,
-  running your code on different platforms greatly increases the
-  reliably. You will find many bugs on one platform that never will be
-  revealed on another.
-- Before and during performance tuning: Make sure that your code
-  delivers the correct results.
+!!! hint "Some general, helpful hints"
 
-Some questions you should ask yourself:
+    - Stick to standards wherever possible, e.g. use the `-std` flag
+      for CLANG, GNU and Intel C/C++ compilers. Computers are short living
+      creatures, migrating between platforms can be painful. In addition,
+      running your code on different platforms greatly increases the
+      reliably. You will find many bugs on one platform that never will be
+      revealed on another.
+    - Compile your code with optimization, e.g. `-O2` will turn on a moderate level of optimization
+      where most optimization algorithms are applied. Please refer to the specific documentation of
+      your compiler of choice for detailed information.
+    - Before and during performance tuning: Make sure that your code delivers the correct results.
 
-- Given that a code is parallel, are the results independent from the
-  numbers of threads or processes?
-- Have you ever run your Fortran code with array bound and subroutine
-  argument checking (the `-check all` and `-traceback` flags
-  for the Intel compilers)?
-- Have you checked that your code is not causing floating point
-  exceptions?
-- Does your code work with a different link order of objects?
-- Have you made any assumptions regarding storage of data objects in
-  memory?
+!!! questions "Some questions you should ask yourself"
+
+    - Given that a code is parallel, are the results independent from the
+      numbers of threads or processes?
+    - Have you ever run your Fortran code with array bound and subroutine argument checking (the
+      `-check all` and `-traceback` flags for the Intel compilers)?
+    - Have you checked that your code is not causing floating point exceptions?
+    - Does your code work with a different link order of objects?
+    - Have you made any assumptions regarding storage of data objects in memory?
-- 
GitLab