Create troubleshooting and FAQ documentation page #267
Description
Summary
Add a dedicated troubleshooting/FAQ page to help users quickly resolve common issues with Apache Shiro configuration and usage.
Current State
There is no centralized troubleshooting guide. Users must search through various documentation pages or mailing list archives to find solutions.
Proposed Changes
Create a new src/site/content/troubleshooting.adoc file covering:
Common Issues to Document
- Session management issues (session timeout, clustering)
- Authentication failures and debugging
- Authorization/permission configuration errors
- Spring Boot integration common pitfalls
- "Remember Me" functionality issues
- Realm configuration problems
- Cache-related issues
Acceptance Criteria
- Create
troubleshooting.adocwith proper JBake metadata - Include at least 10 common Q&A entries
- Add links to related documentation pages
- Add navigation link in appropriate menu/page
- Follow existing AsciiDoc formatting conventions
File Template
= Troubleshooting & FAQ
:jbake-date: 2026-01-18 00:00:00
:jbake-type: page
:jbake-status: published
:jbake-tags: documentation, troubleshooting, faq
:idprefix:
:icons: font
:toc:
== Common Issues
...Metadata
Metadata
Assignees
Labels
No labels