docs: readme

packages/collections-common/composer.json

@@ -1,13 +1,25 @@
 {
     "name": "rekalogika/collections-common",
-    "description": "",
+    "description": "Common library required by other components of the rekalogika/collections library",
     "license": "MIT",
     "type": "library",
     "keywords": [
         "domain",
         "collections",
         "doctrine",
-        "pagination"
+        "pagination",
+        "orm",
+        "recollection",
+        "minimalrecollection",
+        "count",
+        "precounting",
+        "extra-lazy",
+        "rekapager",
+        "keyset-pagination",
+        "cursor-pagination",
+        "batch",
+        "batch-processing",
+        "repository"
     ],
     "authors": [
         {

packages/collections-contracts/README.md

@@ -1,17 +1,6 @@
-# rekalogika/collections-domain
+# rekalogika/collections-contracts
 
-Transforms a Doctrine `Collection` object into our `Recollection` object, which
-extends `Collection` itself but also extends `PageableInterface` from our
-`rekalogika/rekapager` library.
-
-The features include:
-
-* Safeguards against potential out-of-memory situations.
-* Pluggable counting strategies.
-* Keyset pagination for batch processing and user interfaces.
-
-The classes also available in the minimal flavor, which only exposes the safe
-methods, those which won't trigger full load of an extra-lazy collection.
+Interfaces and nominal classes for the `rekalogika/collections` library.
 
 ## Documentation
 

packages/collections-contracts/composer.json

@@ -1,13 +1,25 @@
 {
     "name": "rekalogika/collections-contracts",
-    "description": "",
+    "description": "Interfaces and nominal classes for the rekalogika/collections library.",
     "license": "MIT",
     "type": "library",
     "keywords": [
         "domain",
         "collections",
         "doctrine",
-        "pagination"
+        "pagination",
+        "orm",
+        "recollection",
+        "minimalrecollection",
+        "count",
+        "precounting",
+        "extra-lazy",
+        "rekapager",
+        "keyset-pagination",
+        "cursor-pagination",
+        "batch",
+        "batch-processing",
+        "repository"
     ],
     "authors": [
         {

packages/collections-domain/README.md

@@ -1,11 +1,28 @@
-# Rekalogika Collections Domain
+# rekalogika/collections-domain
 
-TBD
+Transforms a Doctrine `Collection` object into our `Recollection` object, which
+extends `Collection` itself but also extends `PageableInterface` from our
+`rekalogika/rekapager` library.
+
+The features include:
+
+* Safeguards against potential out-of-memory situations.
+* Pluggable counting strategies.
+* Keyset pagination for batch processing and user interfaces.
+
+The classes also available in the minimal flavor, which only exposes the safe
+methods, those which won't trigger full load of an extra-lazy collection.
 
 ## Documentation
 
-TBD
+[rekalogika.dev/collections](https://rekalogika.dev/collections)
 
 ## License
 
-MIT
+MIT
+
+## Contributing
+
+This library consists of multiple repositories split from a monorepo. Be sure to
+submit issues and pull requests to the
+[rekalogika/collections](https://github.com/rekalogika/collections) monorepo.

packages/collections-domain/composer.json

@@ -1,13 +1,25 @@
 {
     "name": "rekalogika/collections-domain",
-    "description": "Improves Doctrine Collections usage in your domain entities.",
+    "description": "Transforms a Doctrine Collection object into our Recollection object, which extends Collection itself but also extends PageableInterface from our rekalogika/rekapager library.",
     "license": "MIT",
     "type": "library",
     "keywords": [
         "domain",
         "collections",
         "doctrine",
-        "pagination"
+        "pagination",
+        "orm",
+        "recollection",
+        "minimalrecollection",
+        "count",
+        "precounting",
+        "extra-lazy",
+        "rekapager",
+        "keyset-pagination",
+        "cursor-pagination",
+        "batch",
+        "batch-processing",
+        "repository"
     ],
     "authors": [
         {

packages/collections-orm/README.md

@@ -1,9 +1,9 @@
 # rekalogika/collections-orm
 
-A collection class using Doctrine ORM `QueryBuilder` as the data source. Unlike
-doing the query in the traditional way, this class allows lazy loading. You can
-safely pass the object around, and it will only execute the query when you start
-getting items from it.
+Lazy-loading collection class using Doctrine ORM `QueryBuilder` as the data
+source. Unlike doing the query in the traditional way, this class allows lazy
+loading. You can safely pass the object around, and it will only execute the
+query when you start getting items from it.
 
 The class also implements the `PageableInterface` from the
 [`rekalogika/rekapager`](https://rekalogika.dev/rekapager) library. This allows

packages/collections-orm/composer.json

@@ -1,13 +1,25 @@
 {
     "name": "rekalogika/collections-orm",
-    "description": "Supercharged query-backed Doctrine Collection.",
+    "description": "Lazy-loading collection class using Doctrine ORM QueryBuilder as the data source",
     "license": "MIT",
     "type": "library",
     "keywords": [
         "domain",
         "collections",
         "doctrine",
-        "pagination"
+        "pagination",
+        "orm",
+        "recollection",
+        "minimalrecollection",
+        "count",
+        "precounting",
+        "extra-lazy",
+        "rekapager",
+        "keyset-pagination",
+        "cursor-pagination",
+        "batch",
+        "batch-processing",
+        "repository"
     ],
     "authors": [
         {