improve documentation

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,5 +1,5 @@
 ---
-name: Bug report
+name: Bug Report
 about: Create a report to help us improve
 title: ''
 labels: ''
@@ -7,32 +7,19 @@ assignees: ''
 
 ---
 
-**Describe the bug**
-A clear and concise description of what the bug is.
+### Describe the Bug
 
-**To Reproduce**
-Steps to reproduce the behavior:
-1. Go to '...'
-2. Click on '....'
-3. Scroll down to '....'
-4. See error
+Please provide a description of the bug.
 
-**Expected behavior**
-A clear and concise description of what you expected to happen.
+### Steps To Reproduce
 
-**Screenshots**
-If applicable, add screenshots to help explain your problem.
+Please provide the steps to reproduce the bug.
 
-**Desktop (please complete the following information):**
- - OS: [e.g. iOS]
- - Browser [e.g. chrome, safari]
- - Version [e.g. 22]
+### Expected Behavior
 
-**Smartphone (please complete the following information):**
- - Device: [e.g. iPhone6]
- - OS: [e.g. iOS8.1]
- - Browser [e.g. stock browser, safari]
- - Version [e.g. 22]
+Please provide a description of the expected behaviour.
 
-**Additional context**
-Add any other context about the problem here.
+### Environment
+
+Please provide details of your environment (e.g.: keycloak version, java version. operating system
+and version, etc.).

SECURITY.md

@@ -1,6 +1,6 @@
 # Security Policy
 
-This project is provided on a 'time-avaialble' basis.
+This project is provided on a 'time-available' basis.
 
 If you have a security concern to report, please open an issue or a pull request.