Skip to content
This repository has been archived by the owner on Dec 18, 2024. It is now read-only.

Book Outline #1

Closed
aphelionz opened this issue Feb 14, 2019 · 0 comments
Closed

Book Outline #1

aphelionz opened this issue Feb 14, 2019 · 0 comments
Assignees

Comments

@aphelionz
Copy link
Collaborator

aphelionz commented Feb 14, 2019

This issue is the scratch pad for the outline and basis for discussion. Feel free to comment here to leave feedback at any time.


The following is extremely subject to change


The OrbitDB Field Manual

*Overall the book is written in 2nd person: You do this, you should know, etc. Parts 1 and 3 are practical, and Parts 2 and 4 are theoretical *

Introduction

Preamble [1p]

Sets the book up with a very loose but catchy narrative about our distributed future and why persistent-yet-malleable data structures are necessary.

What is OrbitDB? [3p]

Non-technical description of OrbitDB. For the technical, we point to Part 1 for a tutorial and part 3 for overall architecture. Briefly touch upon IPFS context.

What can I use it for [2p]

What has already been built with OrbitDB? What can one do with a distributed database like OrbitDB? What apps should be built? Points to Part 2 for ways of thinking distributed.

A Warning to Fellow Travelers in Our Distributed Future [1p]

This is alpha software. Not just OrbitDB, all of it - an entire industry. Be careful. Points to part 4 for Advanced Topics.

Part 1: The Tutorial

An upbeat, imperative romp from empty files to complete app in under 100 pages. Need an idea for an app. Constrained entirely to JavaScript to maximize focus - no HTML or CSS

Coding instructions is interleaved with sections called What Just Happened that tell people what just happened after their code ran.

Chapter 1: Getting Started

Instantiating IPFS and OrbitDB

  • Resolves #367

Creating a Database

Chapter 2: Reading and Writing Data

Choosing a data type

Chapter 3: Peer-to-Peer Replication

Replication Overview

Replicating in the Browser

Replicating in Node.js

Replication between Browser and Node.js

  • Resolves #496

Chapter 4: Identity and Permissions

Access Control

Identity Management

Security Disclosures

  • Resolves: #397
  • Resolves: #222
  • Resolves: #327
  • Resolves: #357
  • Resolves: #475
  • Resolves: #380
  • Resolves: #458
  • Resolves: #467

Part 2: Thinking Peer to Peer

What this is NOT

This is not Bittorrent

This is not Git

This is not Kazaa

Comparison to Traditional Database Systems

On Sharding

What this is

  • Resolves #536

On Performance and Scalability

Persistence and Validation

  • Resolves #36
  • Resolves #310

Interactions with the IPFS Ecosystem

Part 3: The Architecture of OrbitDB

  • Resolves #342 Data persistence on IPFS

ipfs-log

Describes CRDTs and Merkle-Dags

The stores

Keyvalue

Docstore

Counter

Log

Feed

Workshop: Creating Your Own Store

Part 4: What Next?

Appendix 1: CRDTs

Appendix 2: Mobile Ambients: A Peek Ahead

@aphelionz aphelionz self-assigned this Feb 14, 2019
@aphelionz aphelionz changed the title Write Outline Book Outline Feb 15, 2019
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant