Merge pull request #20 from CosmWasm/storage-skeleton

Set up `cw-storage-plus` outline

src/pages/_meta.json

@@ -3,6 +3,7 @@
   "core": "CosmWasm Core",
   "ibc": "IBC",
   "sylvia": "Sylvia",
+  "cw-storage-plus": "cw-storage-plus",
   "cw-multi-test": "MultiTest",
   "how-to-doc": "How to doc",
   "tags": {

src/pages/cw-storage-plus.md

@@ -0,0 +1,4 @@
+# Introduction
+
+TODO: Describe what low-level interface `cw-storage-plus` builds on, and how it
+provides typed abstractions on top of it

src/pages/cw-storage-plus/_meta.json

@@ -0,0 +1,8 @@
+{
+  "basics": "Basics",
+  "containers": "Containers",
+  "key-collisions": "Key collisions",
+  "iteration": "Iteration",
+  "snapshots": "Snapshots",
+  "multi-indexes": "Multi index collections"
+}

src/pages/cw-storage-plus/basics.md

@@ -0,0 +1,4 @@
+# Basics
+
+TODO: Describe the way storage containers generally work, how prefixes provide a
+"slice" of the whole namespace, etc

src/pages/cw-storage-plus/containers/_meta.json

@@ -0,0 +1,5 @@
+{
+  "item": "Item",
+  "map": "Map",
+  "deque": "Deque"
+}

src/pages/cw-storage-plus/containers/deque.mdx

@@ -0,0 +1,7 @@
+# `Deque`
+
+## Overview
+
+## Examples
+
+### ?

src/pages/cw-storage-plus/containers/item.mdx

@@ -0,0 +1,9 @@
+# `Item`
+
+## Overview
+
+## Examples
+
+### Saving an admin address
+
+### Saving a config structure

src/pages/cw-storage-plus/containers/map.mdx

@@ -0,0 +1,7 @@
+# `Map`
+
+## Overview
+
+## Examples
+
+### Keeping users' balances

src/pages/cw-storage-plus/iteration.md

@@ -0,0 +1,9 @@
+# Iteration
+
+TODO: how to generally take advantage of iteration
+
+TODO: bounds, inclusive-exclusive
+
+TODO: `Map` iteration - surprising behavior with order and bounds?
+
+TODO: how to use `Prefix` and such

src/pages/cw-storage-plus/key-collisions.mdx

@@ -0,0 +1,12 @@
+import { Callout } from "nextra/components";
+
+# Key collisions
+
+TODO: Explain how key collisions shouldn't generally happen as long as unique
+prefixes are chosen
+
+<Callout type="warning">
+  Warning here about a potential nefarious key collision below
+</Callout>
+
+https://confio.slack.com/archives/C06A73TKXST/p1709815517501709

src/pages/cw-storage-plus/multi-indexes.md

@@ -0,0 +1,3 @@
+# Multi index collections
+
+TODO: bonus section, maybe flesh out, maybe remove

src/pages/cw-storage-plus/snapshots.md

@@ -0,0 +1,3 @@
+# Snapshots
+
+TODO: bonus section, maybe flesh out, maybe remove