This is an automated email from the ASF dual-hosted git repository.
lprimak pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/shiro-site.git
The following commit(s) were added to refs/heads/main by this push:
new d9b9349e3 This PR updates the documentation to reflect the use of
GitHub Issues and GitHub Discussions, and marks JIRA as legacy for archival
purposes only. Resolves #281. (#282)
d9b9349e3 is described below
commit d9b9349e389491efb6b7d951eec822a491c4c28a
Author: Ganesh Patil <[email protected]>
AuthorDate: Fri Jan 30 23:16:49 2026 +0530
This PR updates the documentation to reflect the use of GitHub Issues and
GitHub Discussions, and marks JIRA as legacy for archival purposes only.
Resolves #281. (#282)
* docs: migrate issue tracking to GitHub Issues and Discussions
* review comments
---------
Co-authored-by: lprimak <[email protected]>
---
src/site/content/community.adoc | 4 +++-
src/site/content/forums.adoc | 18 +++++++++++++++---
src/site/content/issues.adoc | 24 ++++++++++++++++--------
src/site/content/mailing-lists.adoc | 2 +-
4 files changed, 35 insertions(+), 13 deletions(-)
diff --git a/src/site/content/community.adoc b/src/site/content/community.adoc
index 98488fdfa..e71a446f9 100644
--- a/src/site/content/community.adoc
+++ b/src/site/content/community.adoc
@@ -30,6 +30,8 @@ At the Shiro project we make it easy for anyone to join our
great community and
* *link:developer-resources.html[Developer Resources]* - Helpful information
for anyone providing project help as a committer or contributor
-* *https://github.com/apache/shiro/issues[Issue Tracker]* - Once you're ready
to contribute, this is a good place to see what needs to get done
+* *https://github.com/apache/shiro/discussions[GitHub Discussions]* - For
questions, ideas, and community discussion
+
+* *https://github.com/apache/shiro/issues[GitHub Issues]* - For bug reports
and feature requests
* *https://www.apache.org/foundation/sponsorship.html[Donate to ASF]* - Shiro
is a project under the Apache Software Foundation, a non-profit that relies on
donations and community support
diff --git a/src/site/content/forums.adoc b/src/site/content/forums.adoc
index a1846ff43..2dc919c6b 100644
--- a/src/site/content/forums.adoc
+++ b/src/site/content/forums.adoc
@@ -6,7 +6,18 @@
:jbake-description: Access Apache Shiro community forums and mailing list
archives via ASF Pony Mail for user and developer discussions.
:idprefix:
-For users that prefer to use browse the mailing lists with a browser can use
https://lists.apache.org/[ASF Lists] (Pony Mail).
+== Mailing Lists
+
+For those that may prefer mailing lists, please see the
link:mailing-lists.html[Mailing Lists] information.
+____
+
+*NOTE:* The primary forums for Apache Shiro are the mailing lists, which can
be accessed via the link:mailing-lists.html[Mailing Lists] page. This is per
the Apache Software Foundation's community guidelines.
+
+____
+
+== Mailing List Archives
+
+For users that prefer to browse the mailing lists with a browser can use
https://lists.apache.org/[ASF Lists] (Pony Mail).
* link:++https://lists.apache.org/[email protected]++[Shiro User
Forum]
@@ -18,6 +29,7 @@ ____
____
-== Mailing Lists
+== GitHub Discussions
+
+For questions, ideas, and general community discussion, please use
https://github.com/apache/shiro/discussions[GitHub Discussions].
-For those that may prefer mailing lists, please see the
link:mailing-lists.html[Mailing Lists] information.
\ No newline at end of file
diff --git a/src/site/content/issues.adoc b/src/site/content/issues.adoc
index 0e5c0b5f9..79904b4a9 100644
--- a/src/site/content/issues.adoc
+++ b/src/site/content/issues.adoc
@@ -3,24 +3,32 @@
:jbake-type: page
:jbake-status: published
:jbake-tags: issues, bugs, jira, bug-tracking, support
-:jbake-description: Report bugs, request features, and track issues for Apache
Shiro using Atlassian Jira issue tracking system.
+:jbake-description: Report bugs, request features, and track issues for Apache
Shiro using GitHub Issues tracking system.
:idprefix:
:icons: font
-Apache Shiro uses Atlassian Jira for tracking tasks, feature requests, bugs,
and other issues related to the project development.
+Apache Shiro uses https://github.com/apache/shiro/issues[GitHub Issues] for
bug reports, feature requests, and task tracking.
+
+For questions, ideas, and community discussions, please use
https://github.com/apache/shiro/discussions[GitHub Discussions].
== Usage Guidelines
-Jira is provided as a Shiro software development resource.
-It is meant to be for managing bugs, tasks and improvements in the software
itself - it is not a support portal to ask for advice or help.
-For community advice and help in using Apache Shiro, please visit the
link:/support.html[Support] page.
+GitHub Issues is provided as a Shiro software development resource.
+It is meant for reporting bugs, requesting features, and tracking improvements
in the software itself - it is not a support portal to ask for advice or help.
+For community advice and help in using Apache Shiro, please visit the
link:/support.html[Support] page or use
https://github.com/apache/shiro/discussions[GitHub Discussions].
-*Prior to using Jira, we ask that:*
+*Prior to opening an issue, we ask that:*
* You do your due diligence to ensure a suspected error is actually a bug.
* You search the issue tracker to ensure what you want to report has not
already been reported by someone else.
* If your problem is actually a bug, we would appreciate it if you could
attach a simple JUnit test case that allows us to repeat the problem, so we can
fix it as fast as possible.
* If a unit test is not available (please really try to make one!), attach a
stack trace and Shiro's TRACE or DEBUG log output.
-* If you've already fixed the problem, please submit a patch, and we'll likely
include it in the next release.
+* If you've already fixed the problem, please submit a pull request, and we'll
likely include it in the next release.
+
+https://github.com/apache/shiro/issues[Click here to visit the Apache Shiro
GitHub Issues tracker].
+
+== JIRA (Legacy)
+
+JIRA is retained for archival purposes only and is no longer used for new
issues.
-https://issues.apache.org/jira/browse/SHIRO[Click here to visit the Apache
Shiro Jira issue tracker].
+https://issues.apache.org/jira/browse/SHIRO[Click here to visit the legacy
Apache Shiro JIRA issue tracker].
diff --git a/src/site/content/mailing-lists.adoc
b/src/site/content/mailing-lists.adoc
index f2be047a5..4ef1b7849 100644
--- a/src/site/content/mailing-lists.adoc
+++ b/src/site/content/mailing-lists.adoc
@@ -23,7 +23,7 @@
|mailto:[email protected][Unsubscribe]
|link:++https://lists.apache.org/[email protected]++[ASF Forum
and Archive]
-|Shiro Issues/JIRA List
+|Shiro Issues List
|mailto:[email protected][[email protected]]
|mailto:[email protected][Subscribe]
|mailto:[email protected][Unsubscribe]
