Update docs

- Migrate to Grace

- Add changelog for version 6.x

Author: rainboyan

gradle.properties

@@ -13,11 +13,3 @@ chromeDriverVersion=126.0.6478.126
 geckodriverVersion=0.33.0
 seleniumVersion=4.2.2
 webdriverBinariesVersion=3.2
-asciidoc=true
-githubSlug=graceframework/grace-cache
-githubBranch=master
-title=Cache Plugin
-projectDesc=Provides AST transformations for caching method calls
-guide=../../guide
-projectUrl=https://github.com/graceframework/grace-cache
-developers=Michael Yan

src/main/docs/guide/implementation.adoc

@@ -2,14 +2,12 @@ All of the plugin's classes are designed for extensibility; the classes are all
 
 == Cache manager
 
-
 The core cache plugin registers a `grailsCacheManager` Spring bean, and the extension plugins replace this bean with one that creates and manages caches for that implementation. The default implementation is an instance of link:{api}/grails/plugin/cache/GrailsConcurrentMapCacheManager.html[GrailsConcurrentMapCacheManager] which uses link:{api}/grails/plugin/cache/GrailsConcurrentMapCache.html[GrailsConcurrentMapCache] as its cache implementation. It uses a `java.util.concurrent.ConcurrentHashMap` to store cached values.
 
 You can customize the cache manager by replacing the `grailsCacheManager` Spring bean in `resources.groovy` with your own; either subclass link:{api}/grails/plugin/cache/GrailsConcurrentMapCacheManager.html[GrailsConcurrentMapCacheManager] (e.g. to override the `createConcurrentMapCache()` method) or by implementing the link:{api}/org/grails/plugin/cache/GrailsCacheManager.html[GrailsCacheManager] interface.
 
 === Fragment caching
 
-
 You can cache partial GSP page sections with the `<cache:block>` tag. You can specify a key when using this tag but it's in general unnecessary. This is because the block will be rendered with its own Closure, and the default key is the full closure class name. This is unique since the closures aren't re-used; for example these two blocks will be cached independently, even in the same GSP:
 
 [source,groovy]

src/main/docs/guide/introduction.adoc

@@ -1,3 +1,2 @@
-The Grails Cache plugin provides powerful and easy to use caching functionality to Grails applications and plugins.
+Grace Cache plugin provides powerful and easy to use caching functionality to Grace applications and plugins.
 
-IMPORTANT: Cache version 4.0.0 and higher requires GORM 6.1.x or higher

src/main/docs/guide/introduction/changeLog.adoc

@@ -1,4 +1,290 @@
-[[changeLog]]
-=== Change log
-
 For recent versions please check the https://github.com/graceframework/grace-cache/releases[release notes].
+
+=== 6.3.0-RC1
+
+https://github.com/graceframework/grace-cache/releases/tag/v6.3.0-RC1[release notes]
+
+🛠 Improvements
+
+* Update README Update badge versions of Grace, Groovy and Spring Boot
+* Streamline Gradle build scripts: using the Spring Dependency Management Plugin to manage dependencies and versions link:{issues}/54[#54]
+* Remove the unnecessary workaround for removing the generated extra dependencyManagement of POM link:{issues}/53[#53]
+
+🚀 Dependency Upgrades
+
+* Upgrade to Grace 2023.3.0-M2 link:{issues}/48[#48]
+* Upgrade to Grace Data 2023.3.0-RC1 link:{issues}/49[#49]
+* Upgrade to Groovy 4.0.26 link:{issues}/50[#50]
+* Upgrade to Java Parser 3.26.4 link:{issues}/51[#51]
+* Upgrade to Spring Boot 3.3.10 link:{issues}/52[#52]
+
+⚙️ Tasks
+
+* Release v6.3.0-RC1
+* build: update GitHub workflows 
+
+=== 6.3.0-M1
+
+https://github.com/graceframework/grace-cache/releases/tag/v6.3.0-M1[release notes]
+
+🛠 Improvements
+
+* Update README
+* Update github workflows Switch to 6.3.x branch
+
+🚀 Dependency Upgrades
+
+* Upgrade to AssertJ 3.25.3 link:{issues}/45[#45]
+* Upgrade to CGLib Nodep 3.3.0 link:{issues}/46[#46]
+* Upgrade to Grace 2023.3.0-M1 link:{issues}/43[#43]
+* Upgrade to Grace Data 2023.3.0-M1 link:{issues}/47[#47]
+* Upgrade to Spring Boot 3.3.7 link:{issues}/44[#44]
+
+⚙️ Tasks
+
+* Release v6.3.0-M1
+* Set version to 6.3.0-SNAPSHOT
+
+=== 6.2.0
+
+https://github.com/graceframework/grace-cache/releases/tag/v6.2.0[release notes]
+
+🛠 Improvements
+
+* Update README 
+* Add GitHub issue template link:{issues}/40[#40]
+* Update build scripts to avoid deprecation warnings with Gradle 8 link:{issues}/39[#39]
+
+🚀 Dependency Upgrades
+
+* Upgrade to Grace 2023.2.0-RC1 link:{issues}/38[#38]
+* Upgrade to Grace Data 2023.2.0 link:{issues}/41[#41]
+
+⚙️ Tasks
+
+* Release v6.2.0
+
+=== 6.2.0-RC1
+
+https://github.com/graceframework/grace-cache/releases/tag/v6.2.0-RC1[release notes]
+
+🛠 Improvements
+
+* Excludes demo classes in plugin jar link:{issues}/37[#37]
+
+🚀 Dependency Upgrades
+
+* Upgrade to Grace 2023.2.0-M3 link:{issues}/35[#35]
+* Upgrade to Grace 2023.2.0-M2 link:{issues}/33[#33]
+* Upgrade to Grace Data 2023.2.0-RC1 link:{issues}/34[#34]
+* Upgrade to Gradle 8.12 link:{issues}/36[#36]
+
+⚙️ Tasks
+
+* Release v6.2.0-RC1
+
+=== 6.2.0-M1
+
+https://github.com/graceframework/grace-cache/releases/tag/v6.2.0-M1[release notes]
+
+🛠 Improvements
+
+* Update README Update badge of Grace to current version
+* Update github workflows 
+
+🚀 Dependency Upgrades
+
+* Upgrade to Grace 2023.2.0-M1 link:{issues}/28[#28]
+* Upgrade to Grace Data 2023.2.0-M1 link:{issues}/32[#32]
+* Upgrade to JUnit Jupiter 5.10.5 link:{issues}/30[#30]
+* Upgrade to JUnit Platform 1.10.5 link:{issues}/31[#31]
+* Upgrade to Spring Boot 3.2.12 link:{issues}/29[#29]
+
+⚙️ Tasks
+
+* Release v6.2.0-M1
+* Set version to 6.2.0-SNAPSHOT
+
+=== 6.1.0
+
+https://github.com/graceframework/grace-cache/releases/tag/v6.1.0[release notes]
+
+🛠 Improvements
+
+* Update Badges 
+* Use Java 17 toolchain link:{issues}/26[#26]
+
+⚙️ Tasks
+
+* Release v6.1.0
+
+🚀 Dependency Upgrades
+
+* Upgrade to Grace 2023.1.0-RC1 link:{issues}/23[#23]
+* Upgrade to Grace Data 2023.1.0 link:{issues}/24[#24]
+* Upgrade to Groovy 4.0.24 link:{issues}/25[#25]
+
+=== 6.1.0-RC1
+
+https://github.com/graceframework/grace-cache/releases/tag/v6.1.0-RC1[release notes]
+
+🛠 Improvements
+
+* Use `classesDirectory` property instead of deprecated `outputDir` link:{issues}/22[#22]
+* Add dependency `jakarta.annotation-api` explicitly link:{issues}/20[#20]
+* Update build scripts 
+
+🚀 Dependency Upgrades
+
+* Upgrade to Grace 2023.1.0-M3 link:{issues}/18[#18]
+* Upgrade to Grace Data 2023.1.0-RC1 link:{issues}/19[#19]
+* Upgrade to Gradle Nexus Publish Plugin 2.0.0 link:{issues}/21[#21]
+
+⚙️ Tasks
+
+* Release v6.1.0-RC1 
+
+=== 6.1.0-M3
+
+https://github.com/graceframework/grace-cache/releases/tag/v6.1.0-M3[release notes]
+
+🛠 Improvements
+
+* Generate Spring Boot configuration metadata file link:{issues}/16[#16]
+
+🚀 Dependency Upgrades
+
+* Upgrade to Grace 2023.1.0-M2 link:{issues}/15[#15]
+* Upgrade to Grace Data 2023.1.0-M3 link:{issues}/17[#17]
+
+⚙️ Tasks
+
+* Release v6.1.0-M3
+
+=== 6.1.0-M2
+
+https://github.com/graceframework/grace-cache/releases/tag/v6.1.0-M2[release notes]
+
+🛠 Improvements
+
+* Enable `CacheProperties` to generate metadata Use Java rewriting and renaming `CachePluginConfiguration` to `CacheProperties` link:{issues}/14[#14]
+* Update meta info of Cache plugin link:{issues}/13[#13]
+* Use `ClearCachesApplicationListener` replace of `Plugin.doWithApplicationContext` link:{issues}/12[#12]
+* Update README
+* Enable Unit Tests link:{issues}/10[#10]
+* Auto-Configure Cache Plugin link:{issues}/7[#7]
+
+🚀 Dependency Upgrades
+
+* Upgrade to Grace 2023.1.0-M1 link:{issues}/3[#3]
+* Upgrade to Grace Data 2023.1.0-M2 link:{issues}/11[#11]
+* Upgrade to Jansi 2.4.0 link:{issues}/4[#4]
+* Upgrade to Java Parser 3.26.2 link:{issues}/5[#5]
+* Upgrade to Javassist 3.30.2-GA link:{issues}/6[#6]
+* Upgrade to Selenium 4.2.2 link:{issues}/9[#9]
+* Upgrade to Webdriver Binaries Gradle Plugin 3.2 link:{issues}/8[#8]
+
+⚙️ Tasks
+
+* Release v6.1.0-M2
+
+=== 6.1.0-M1
+
+https://github.com/graceframework/grace-cache/releases/tag/v6.1.0-M1[release notes]
+
+🛠 Improvements
+
+* Update README
+* Update README
+* Update README
+
+🚀 Dependency Upgrades
+
+* Upgrade to Grace 2023.0.2
+* Upgrade to Groovy 4.0.23
+* Upgrade to GORM 2023.1.0-M1 link:{issues}/2[#2]
+
+⚙️ Tasks
+
+* Release v6.1.0-M1
+* Update github workflows
+* Set version to 6.1.0-SNAPSHOT
+
+=== 6.0.1
+
+https://github.com/graceframework/grace-cache/releases/tag/v6.0.1[release notes]
+
+* Release v6.0.1
+* Upgrade to Grace Geb Plugin 6.0.1
+* Upgrade to GORM 2023.0.1
+* Upgrade to Grace 2023.0.0
+* Set version to 6.0.1-SNAPSHOT
+
+=== 6.0.0
+
+https://github.com/graceframework/grace-cache/releases/tag/v6.0.0[release notes]
+
+* Release v6.0.0
+* Upgrade to Grace Geb Plugin 6.0.0
+* Upgrade to GORM 2023.0.0
+* Upgrade to Groovy 4.0.22
+* Upgrade to Grace 2023.0.0-RC2
+
+=== 6.0.0-RC1
+
+https://github.com/graceframework/grace-cache/releases/tag/v6.0.0-RC1[release notes]
+
+* Release v6.0.0-RC1
+* Upgrade to Grace Geb Plugin 6.0.0-RC1
+* Upgrade to GORM 2023.0.0-RC1
+* Upgrade to Gradle Wrapper 7.6.4
+* Upgrade to Groovy 4.0.21
+* Upgrade to Grace 2023.0.0-M7
+* Remove unused grailsw
+* Set `archiveClassifier` with 'plugin'
+* Update github workflows
+* Back to 6.0.0-SNAPSHOT
+
+=== 6.0.0-M3
+
+https://github.com/graceframework/grace-cache/releases/tag/v6.0.0-M3[release notes]
+
+* Release v6.0.0-M3
+* Upgrade to Grace Geb Plugin 6.0.0-M2
+* Add artifact `grails-plugin.xml`
+* Upgrade to Grace GORM 2023.0.0-M5
+* Upgrade to Grace 2023.0.0-M6
+* Grace: update github workflows
+* Grace: migrate to grace
+* Upgrade to Groovy 4.0.12
+
+=== 6.0.0-M2
+
+https://github.com/graceframework/grace-cache/releases/tag/v6.0.0-M2[release notes]
+
+* Release v6.0.0-M2
+* Upgrade to Grace Geb Plugin 6.0.0-M1
+* Upgrade to Grace Data 2023.0.0-M4
+* Upgrade to Grace 2023.0.0-M5
+* Grace: update github workflows
+* Grace: migrate to grace
+* Adding spockVersion in gradle.properties
+* Back to Snapshots
+
+=== 6.0.0-M1
+
+https://github.com/graceframework/grace-cache/releases/tag/v6.0.0-M1[release notes]
+
+* Grace: update github workflows
+* Update plugin info
+* Grace: update build scripts
+* Configure spockVersion property
+* Grace: update github workflows
+* Grace: update build scripts
+* Upgrade to Groovy 4.0.11
+* Upgrade to Grace GORM 2023.0.0-M2
+* Upgrade to Grace 2023.0.0-M2
+* Grace: migrate to grace
+* Migrate to Jakarta: Jakarta Servlet 6.0.0
+* Force to use Groovy 4
+* Build target to Java 17

src/main/docs/guide/usage.adoc

@@ -1,31 +1,7 @@
-The cache plugin adds Spring bean method call, GSP page fragment and
-template caching to Grails applications. You configure one or more caches
-in `grails-app/conf/application.yml`, and
-annotate methods (either in Spring beans (typically Grails services)) to be cached.
-You can also wrap GSP sections in cache tags and render cached templates.
+The cache plugin adds Spring bean method call, GSP page fragment and template caching to Grace applications. You configure one or more caches in `app/conf/application.yml`, and annotate methods (either in Spring beans (typically Grace services)) to be cached. You can also wrap GSP sections in cache tags and render cached templates.
 
-There are three annotations; link:{api}/grails/plugin/cache/Cacheable.html[Cacheable],
-link:{api}/grails/plugin/cache/CachePut.html[CachePut],
-and link:{api}/grails/plugin/cache/CacheEvict.html[CacheEvict]. You use
-`Cacheable` to mark a method as one that should check the cache for a
-pre-existing result, or generate a new result and cache it. Use `CachePut` to
-mark a method as one that should always be evaluated and store its result in the
-cache regardless of existing cache values. And use `@CacheEvict` to flush a cache
-(either fully or partially) to force the re-evaluation of previously cached
-results.
+There are three annotations; link:{api}/grails/plugin/cache/Cacheable.html[Cacheable], link:{api}/grails/plugin/cache/CachePut.html[CachePut], and link:{api}/grails/plugin/cache/CacheEvict.html[CacheEvict]. You use `Cacheable` to mark a method as one that should check the cache for a pre-existing result, or generate a new result and cache it. Use `CachePut` to mark a method as one that should always be evaluated and store its result in the cache regardless of existing cache values. And use `@CacheEvict` to flush a cache (either fully or partially) to force the re-evaluation of previously cached results.
 
-When using distributed caching (such as ehcache with distributed cache enabled,
-or redis with multiple instances of the application running against one redis
-instance), all classes that use annotation caching or XML caching should
-override the `hashCode` method. The hash code of the object with the method
-marked as being cacheable is included in the cache key, and the default
-`hashCode` implementation will vary each time the application is run. Overriding
-`hashCode` ensures that each instance of the applications will appropriately
-share cache keys.
+When using distributed caching (such as ehcache with distributed cache enabled, or redis with multiple instances of the application running against one redis instance), all classes that use annotation caching or XML caching should override the `hashCode` method. The hash code of the object with the method marked as being cacheable is included in the cache key, and the default `hashCode` implementation will vary each time the application is run. Overriding `hashCode` ensures that each instance of the applications will appropriately share cache keys.
 
-This 'core' cache plugin uses an in-memory implementation where the caches and
-cache manager are backed by a thread-safe `java.util.concurrent.ConcurrentMap`.
-This is fine for testing and possibly for low-traffic sites, but you should
-consider using one of the extension plugins if you need clustering, disk
-storage, persistence between restarts, and more configurability of features like
-time-to-live, maximum cache size, etc. Currently the only extension plugin available for Grails 3 is https://plugins.grails.org/plugin/grails/cache-ehcache[cache-ehcache].
+This 'core' cache plugin uses an in-memory implementation where the caches and cache manager are backed by a thread-safe `java.util.concurrent.ConcurrentMap`. This is fine for testing and possibly for low-traffic sites, but you should consider using one of the extension plugins if you need clustering, disk storage, persistence between restarts, and more configurability of features like time-to-live, maximum cache size, etc.

src/main/docs/guide/usage/annotations.adoc

@@ -112,5 +112,5 @@ class Message implements Serializable {
 
 Note that for in-memory cache implementations it's not required that the objects being cached implement `Serializable` but if you use an implementation that uses Java serialization (for example the Redis plugin, or the Ehcache plugin when you have configured clustered caching) you must implement `Serializable`.
 
-To test this out, be sure to define a `"message"` cache in `grails-app/conf/application.yml` and save and retrieve `Message` instances using the service. There are `println` statements but you can also turn on SQL logging to watch the database access that's needed to retrieve instances that aren't cached yet, and you shouldn't see database access for cached values.
+To test this out, be sure to define a `"message"` cache in `app/conf/application.yml` and save and retrieve `Message` instances using the service. There are `println` statements but you can also turn on SQL logging to watch the database access that's needed to retrieve instances that aren't cached yet, and you shouldn't see database access for cached values.