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