chore(docs): Add FAQs section to docs with information about Lombok support. (#680)

* chore(docs): Add FAQs section to docs with information about Lombok support.

* chore(docs): Fix highlighting of code snipped in FAQ

Author: kozub

docs/FAQs.md

@@ -0,0 +1,28 @@
+---
+title: FAQs
+description: Frequently Asked Questions
+---
+
+
+## How can I use Powertools with Lombok?
+
+Poweretools uses `aspectj-maven-plugin` to compile-time weave (CTW) aspects into the project. In case you want to use `Lombok` or other compile-time preprocessor for your project, it is required to change `aspectj-maven-plugin` configuration to enable in-place weaving feature. Otherwise the plugin will ignore changes introduced by `Lombok` and will use `.java` files as a source. 
+
+To enable in-place weaving feature you need to use following `aspectj-maven-plugin` configuration:
+
+```xml hl_lines="2-6"
+<configuration>
+    <forceAjcCompile>true</forceAjcCompile> 
+    <sources/>
+    <weaveDirectories>
+        <weaveDirectory>${project.build.directory}/classes</weaveDirectory>
+    </weaveDirectories>
+    ...
+    <aspectLibraries>
+        <aspectLibrary>
+            <groupId>software.amazon.lambda</groupId>
+            <artifactId>powertools-logging</artifactId>
+        </aspectLibrary>
+    </aspectLibraries>
+</configuration>
+```

mkdocs.yml

@@ -4,6 +4,7 @@ site_author: Amazon Web Services
 nav:
   - Homepage: index.md
   - Changelog: changelog.md
+  - FAQs: FAQs.md
   - Core utilities:
       - core/logging.md
       - core/tracing.md