docs: clarify custom-repo docs

chore: bump custom repo example ipfs-repo version

examples/custom-ipfs-repo/README.md

@@ -16,6 +16,9 @@ You can find full details on customization in the [IPFS Repo Docs](https://githu
 
 ## Other Options
 
+### Custom `storageBackends`
+This example leverages [datastore-fs](https://github.com/ipfs/js-datastore-fs) to store all data in the IPFS Repo. You can customize each of the 4 `storageBackends` to meet the needs of your project. For an example on how to manage your entire IPFS REPO on S3, you can see the [datastore-s3 example](https://github.com/ipfs/js-datastore-s3/tree/master/examples/full-s3-repo).
+
 ### Custom Repo Lock
 This example uses one of the locks that comes with IPFS Repo. If you would like to control how locking happens, such as with a centralized S3 IPFS Repo, you can pass in your own custom lock. See [custom-lock.js](./custom-lock.js) for an example of a custom lock that can be used for [datastore-s3](https://github.com/ipfs/js-datastore-s3).
 

examples/custom-ipfs-repo/index.js

@@ -25,26 +25,30 @@ const customRepositoryOptions = {
    * in `storageBackends`. If you create a custom datastore, this is where you can pass in
    * custom constructor arguments. You can see an S3 datastore example at:
    * https://github.com/ipfs/js-datastore-s3/tree/master/examples/full-s3-repo
+   *
+   * NOTE: The following options are being overriden for demonstration purposes only.
+   * In most instances you can simply use the default options, by not passing in any
+   * overrides, which is recommended if you have no need to override.
    */
   storageBackendOptions: {
     root: {
-      extension: '.ipfsroot', // Used by datastore-fs; Appended to all files
+      extension: '.ipfsroot', // Defaults to ''. Used by datastore-fs; Appended to all files
       errorIfExists: false, // Used by datastore-fs; If the datastore exists, don't throw an error
       createIfMissing: true // Used by datastore-fs; If the datastore doesn't exist yet, create it
     },
     blocks: {
       sharding: false, // Used by IPFSRepo Blockstore to determine sharding; Ignored by datastore-fs
-      extension: '.ipfsblock',
+      extension: '.ipfsblock', // Defaults to '.data'.
       errorIfExists: false,
       createIfMissing: true
     },
     keys: {
-      extension: '.ipfskey',
+      extension: '.ipfskey', // No extension by default
       errorIfExists: false,
       createIfMissing: true
     },
     datastore: {
-      extension: '.ipfsds',
+      extension: '.ipfsds', // No extension by default
       errorIfExists: false,
       createIfMissing: true
     }

examples/custom-ipfs-repo/package.json

@@ -11,6 +11,6 @@
   "dependencies": {
     "datastore-fs": "~0.4.2",
     "ipfs": "file:../../",
-    "ipfs-repo": "~0.19.0"
+    "ipfs-repo": "^0.20.0"
   }
 }