docs: rephrase the wording to make it more clear

Author: Joris Conijn

CONTRIBUTING.md

@@ -71,7 +71,14 @@ If you discover a potential security issue in this project we ask that you notif
 
 ## Troubleshooting
 
-* The local **API reference** throws a `Module aws_lambda_powertools not found` error when an exception is raised in the code-base, when you run `poetry run pdoc --pdf aws_lambda_powertools` the exception is shown.
+### API reference documentation
+
+When you are working on the codebase and you use the local API reference documentation to preview you changes you might se the following message: `Module aws_lambda_powertools not found`.
+
+This happens when:
+
+* You did not install the local dev environment yet. The solution for that would be running: `make dev`
+* Another option is that the code in the repository is raising an exception while the `pdoc` is scanning the codebase. Unfortunately this exception is not shown to you, but if you run `poetry run pdoc --pdf aws_lambda_powertools` the exception is shown and you can prevent the exception from being raised. Once resolved the documentation should load correctly again.
 
 ## Licensing