GaneshPatil7517 opened a new issue, #267: URL: https://github.com/apache/shiro-site/issues/267
## 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.adoc` with 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 ```asciidoc = 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 ... -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
