You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@shiro.apache.org by "GaneshPatil7517 (via GitHub)" <gi...@apache.org> on 2026/02/06 04:30:30 UTC
[PR] docs: improve documentation content structure [shiro-site]
GaneshPatil7517 opened a new pull request, #292:
URL: https://github.com/apache/shiro-site/pull/292
This PR improves the overall structure and completeness of the Shiro site
documentation by addressing stub content, improving navigation, and clarifying
how tutorials, guides, and release notes fit together.
Resolves #287.
--
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: dev-unsubscribe@shiro.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] docs: improve documentation content structure [shiro-site]
Posted by "lprimak (via GitHub)" <gi...@apache.org>.
lprimak merged PR #292:
URL: https://github.com/apache/shiro-site/pull/292
--
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: dev-unsubscribe@shiro.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org
Re: [PR] docs: improve documentation content structure [shiro-site]
Posted by "Copilot (via GitHub)" <gi...@apache.org>.
Copilot commented on code in PR #292:
URL: https://github.com/apache/shiro-site/pull/292#discussion_r2772233770
##########
src/site/content/documentation.adoc:
##########
@@ -9,18 +9,24 @@
== Introduction
-Helpful if read in order:
+This page serves as the central hub for all Apache Shiro documentation. Whether you are just getting started or looking for detailed reference material, you will find links to the appropriate resources here.
+
+=== New to Shiro?
+
+If you are new to Apache Shiro, we recommend reading these resources in order:
* https://www.infoq.com/articles/apache-shiro[Application Security with Apache Shiro] - full intro article on InfoQ.com
-* link:10-minute-tutorial.html[10 Minute Tutorial]
-* link:webapp-tutorial.html[Beginner's Webapp Tutorial: a step-by-step tutorial to enable Shiro in a web application]
+* link:10-minute-tutorial.html[10 Minute Tutorial] - quick hands-on introduction
+* link:webapp-tutorial.html[Beginner's Webapp Tutorial] - step-by-step guide to enable Shiro in a web application
* https://start.flowlogix.com[Flowlogix Starter] - generate Jakarta EE projects with Shiro support
+Once you understand the basics, explore the link:/guides.html[Guides] page for a complete learning path.
Review Comment:
For consistency with other internal links in this file, consider using a relative path format 'link:guides.html' instead of 'link:/guides.html'. All other internal links in this file use the relative path format without the leading slash.
```suggestion
Once you understand the basics, explore the link:guides.html[Guides] page for a complete learning path.
```
##########
src/site/content/forums.adoc:
##########
@@ -2,22 +2,10 @@
:jbake-date: 2010-03-18 00:00:00
:jbake-type: page
:jbake-status: published
-:jbake-tags: forums, community, support, discussions
-:jbake-description: Access Apache Shiro community forums and mailing list archives via ASF Pony Mail for user and developer discussions.
+:jbake-tags: documentation, community
:idprefix:
-== 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).
+For users that prefer to use browse the mailing lists with a browser can use https://lists.apache.org/[ASF Lists] (Pony Mail).
Review Comment:
There is a grammatical error in this sentence. It should read "For users that prefer to browse the mailing lists with a browser..." (remove "use" before "browse").
```suggestion
For users that prefer to browse the mailing lists with a browser can use https://lists.apache.org/[ASF Lists] (Pony Mail).
```
--
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: dev-unsubscribe@shiro.apache.org
For queries about this service, please contact Infrastructure at:
users@infra.apache.org