docs(updated some documentations): added missing issue templates, updated documentation

Author: ghaschel

.github/ISSUE_TEMPLATE/bug_report.md

@@ -4,24 +4,35 @@ about: Create a report to help me fix it
 title: Simple description of the bug
 labels: bug
 assignees: ghaschel
-
 ---
 
-Please provide the maximum amount of information in order for me to be able to fix it quicker
+Please provide the maximum amount of information in order for me to be able to fix it quicker.
+
+Please, read the [F.A.Q.](../../docs/FAQ.md) before. Your bug might not be a bug.
+
+**Have you read the F.A.Q.?**
+
+- [ ] No
+- [ ] Yes, but my issue has nothing to do with anything in there, or it does but something is broken.
 
 **Describe the bug**
- - A clear and concise description of what the bug is.
+
+- A clear and concise description of what the bug is.
 
 **List of installed/enabled extensions**
 Provide a list of installed/enabled extensions. Also, try to pinpoint which extension might be conflicting with the current one if that's the case.
- - Provide an extension list screenshot of extensions ids [e.g. `ghaschel.vscode-angular-html`]
+
+- Provide an extension list screenshot of extensions ids [e.g. `ghaschel.vscode-angular-html`]
 
 **OS (please provide the following information):**
- - OS and Version: [e.g. Windows 10/11, Ubuntu 18.04, MacOS Catalina]
- - VSCode version
+
+- OS and Version: [e.g. Windows 10/11, Ubuntu 18.04, MacOS Catalina]
+- VSCode version
 
 **Expected behavior**
- - A clear and concise description of what you expected to happen.
+
+- A clear and concise description of what you expected to happen.
 
 **Additional context**
- - Add any other context about the problem here. [e.g. extension Y is not being used at its latest version, but instead, version x.y.z]
+
+- Add any other context about the problem here. [e.g. extension Y is not being used at its latest version, but instead, version x.y.z]

README.md

@@ -12,12 +12,12 @@
     <img src="assets/angular-html.png" title="vscode-angular-html" alt="Logo" />
 </div>
 
+> Note: No theme will have the highlighting displayed in these images. For that effect, run the `vscode-angular-html: Set legacy color customizations` command from the command pallete and you're good to go.
+
 ## Angular HTML Template Syntax Highlighting
 
 This plugin adds syntax highlighting for angular HTML template files in VS Code. It supports the angular syntax itself, HTML DOM events, SVG, XML (with DTD and namespaces support), emphasizes deprecated and obsolete tags and attributes usage according to the current status of HTML. Also supports custom colors for extra-matched scopes. See [color customizations](docs/COLOR-CUSTOMIZATIONS.MD)
 
-> Note: VSCode's default Dark+ theme doesn't have the highlighting displayed in these images. For that effect, run the `vscode-angular-html: Set legacy color customizations` command".
-
 # Summary
 
 - [vscode-angular-html](#vscode-angular-html)

docs/FAQ.md

@@ -0,0 +1,15 @@
+# Frequently Asked Questions
+
+> This document will cover all the most asked questions so far.
+
+- [Frequently Asked Questions](#frequently-asked-questions)
+  - [My Highlighting is not working as in previous versions.](#my-highlighting-is-not-working-as-in-previous-versions)
+  - [How can I request a new theme, or a change to an already supported theme?](#how-can-i-request-a-new-theme-or-a-change-to-an-already-supported-theme)
+
+## My Highlighting is not working as in previous versions.
+
+This extension was written a long time ago, when I didn't know much of what I was doing with TextMate Grammars, so I wrote it just to get some light in my undistinguable-from-html Angular templates. But that caused it to only work greatly with a few themes, and thus, not being everyone's cup of tea. So in order to be able to make it customizable, I have added a Settings session, in which you can change all of your extra-matched characters colors so that it fits exactly to your taste. Please, bear in mind that this will not theme-specific. If you change a theme, you might need to edit again. That said, there is a alternative for those who just want to get the legacy colors customizations back on. You can run the `vscode-angular-html: Set legacy colors customizations` command in the command pallete, and it will work just as before. For the list of supported themes for the legacy colors customization, refer to [supported themes](SUPPORTED-THEMES.md).
+
+## How can I request a new theme, or a change to an already supported theme?
+
+Please, follow [this link](https://github.com/ghaschel/vscode-angular-html/issues/new?assignees=ghaschel&labels=theme+support&template=theme_support.md&title=Support+extra-matched+characters+colors+for+XYZ+theme).

docs/SUPPORTED-THEMES.md

@@ -0,0 +1,29 @@
+# Custom Scope Names
+
+> Here you can find the list of supported themes.
+> If you want to ask for support for a specific theme, please refer to the [F.A.Q.](FAQ.md).
+
+## Supported Themes
+
+- [C/C++ Themes](https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools-themes)
+- [One Dark Pro](https://marketplace.visualstudio.com/items?itemName=zhuangtongfa.Material-theme)
+- [Github Theme](https://marketplace.visualstudio.com/items?itemName=GitHub.github-vscode-theme)
+- [Dracula Official](https://marketplace.visualstudio.com/items?itemName=dracula-theme.theme-dracula)
+- [Atom One Dark Theme](https://marketplace.visualstudio.com/items?itemName=akamud.vscode-theme-onedark)
+- [Community Material Theme](https://marketplace.visualstudio.com/items?itemName=Equinusocio.vsc-community-material-theme)
+- [Winter Is Coming Theme](https://marketplace.visualstudio.com/items?itemName=johnpapa.winteriscoming)
+- [Monokai Pro](https://marketplace.visualstudio.com/items?itemName=monokai.theme-monokai-pro-vscode)
+- [Night Owl](https://marketplace.visualstudio.com/items?itemName=sdras.night-owl)
+- [Material Theme](https://marketplace.visualstudio.com/items?itemName=Equinusocio.vsc-material-theme)
+- [Ayu](https://marketplace.visualstudio.com/items?itemName=teabyii.ayu)
+- [One Monokai Theme](https://marketplace.visualstudio.com/items?itemName=azemoh.one-monokai)
+- [SynthWave '84](https://marketplace.visualstudio.com/items?itemName=RobbOwen.synthwave-vscode)
+- [Visual Studio 2019 Theme](https://marketplace.visualstudio.com/items?itemName=kast789.vs-2019-theme)
+- [Monokai Dark Soda](https://marketplace.visualstudio.com/items?itemName=AdamCaviness.theme-monokai-dark-soda)
+- [Darcula Theme - WebStorm Edition](https://marketplace.visualstudio.com/items?itemName=rexebin.dracula)
+- [Dark Purple - WebStorm Edition](https://marketplace.visualstudio.com/items?itemName=rexebin.darkpurple)
+- [Darcula Theme - Black Edition](https://marketplace.visualstudio.com/items?itemName=rexebin.dracula-black)
+- [Dark Purple - Black Edition](https://marketplace.visualstudio.com/items?itemName=rexebin.darkpurple-black)
+- [One Dark Pro Monokai Darker Theme](https://marketplace.visualstudio.com/items?itemName=eserozvataf.one-dark-pro-monokai-darker)
+- All the default ones
+- Generic Fallback

docs/THEMING.md

@@ -1,6 +1,8 @@
 # Custom Scope Names
 
-> This file aims to be used as a way to point out the extra-matched scopes for themes to be able to support them
+> This file aims to be used as a way to point out the extra-matched scopes for themes to be able to support them.
+
+> This extension also has support for specific themes when enabling legacy colors customization, and as a fallback, it **_tries_** to generate a color-pallete based on the current theme. For the list of supported themes, please refer to [supported themes](SUPPORTED-THEMES.md).
 
 ## Summary