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: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
