tweak text

esp8266 · d-a-v · Mar 29, 2023 · Jan 29, 2023 · Jan 30, 2023 · Jan 30, 2023
commit 94e165d74cbbbff56ef4a076e1e1a973fd2c64d1
diff --git a/doc/Troubleshooting/stack_dump.rst b/doc/Troubleshooting/stack_dump.rst
@@ -57,11 +57,12 @@ the hex after are the stack dump.
 Decode
 ~~~~~~
 
-It's possible to decode the Stack to readable information. For more info see the `Esp Exception Decoder <https://github.com/me-no-dev/EspExceptionDecoder>`__ tool.
+It's possible to decode the Stack to readable information.
+You can get a copy and read about the `Esp Exception Decoder <https://github.com/me-no-dev/EspExceptionDecoder>`__ tool.
+
+For a troubleshooting example using the Exception Decoder Tool, read `FAQ: My ESP Crashes <../faq/a02-my-esp-crashes.rst#exception-decoder>`__.
 
 .. figure:: ESP_Exception_Decoderp.png
    :alt: ESP Exception Decoder
 
    ESP Exception Decoder
-
-For more on troubleshooting, read `FAQ: My ESP Crashes <../faq/a02-my-esp-crashes.rst>`__.
diff --git a/doc/faq/a02-my-esp-crashes.rst b/doc/faq/a02-my-esp-crashes.rst
@@ -302,10 +302,10 @@ When you select ``Debug Optimization: Lite`` on the Arduino IDE Tools menu, it
 turns off ``optimize-sibling-calls``. Turning off this optimization allows more
 caller addresses to be written to the stack, improving the results from the
 Exception Decoder. Without this option, the callers involved in the crash may be
-missing from the results. Because of the limited stack space, there is the
-remote possibility that removing this optimization could lead to more frequent
-stack overflows. You only want to do this in a debug setting. This option does
-not help the chained function issue.
+missing from the Decoder results. Because of the limited stack space, there is
+the remote possibility that removing this optimization could lead to more
+frequent stack overflows. You only want to do this in a debug setting. This
+option does not help the chained function issue.
 
 When you select ``Debug Optimization: Optimum``, you get an even more complete
 stack trace. For example, chained function calls may show up. This selection

diff --git a/platform.txt b/platform.txt
@@ -44,7 +44,7 @@ build.stdcpp_level=-std=gnu++17
 
 build.stacksmash_flags=
 
-# legacy fallback
+# Default - never leave undefined
 build.debug_optim=-Os
 
 build.float=-u _printf_float -u _scanf_float