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**
+### Describe the Bug
-A clear and concise description of what the bug is.
 
-**To Reproduce**
+Please provide a description of the bug.
-Steps to reproduce the behavior:
-1. Go to '...'
-2. Click on '....'
-3. Scroll down to '....'
-4. See error
 
-**Expected behavior**
+### Steps To Reproduce
-A clear and concise description of what you expected to happen.
 
-**Screenshots**
+Please provide the steps to reproduce the bug.
-If applicable, add screenshots to help explain your problem.
 
-**Desktop (please complete the following information):**
+### Expected Behavior
- - OS: [e.g. iOS]
- - Browser [e.g. chrome, safari]
- - Version [e.g. 22]
 
-**Smartphone (please complete the following information):**
+Please provide a description of the expected behaviour.
- - Device: [e.g. iPhone6]
- - OS: [e.g. iOS8.1]
- - Browser [e.g. stock browser, safari]
- - Version [e.g. 22]
 
-**Additional context**
+### Environment
-Add any other context about the problem here.
+
+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.