# TBD Developer Docs, Sitemap

Status: Draft (ready for second review)
DRI: Bobbilee

# Getting Started (Docs Home, Icon: Home)
- (Editorial note: This is the docs home. This represents Getting Started w/ the TBD ecosystem - for this phase we'll be principally promoting Web5, but this may also accommodate tbDEX and other top-level projects when ready)
- (All visual notes are in template)
- Hero CTAs (primary thing we are promoting)
- Top Target - What do we want to promote top banner, "Web5 SDK just launched"
- LEFT: Build / Quickstart code snippet expo example
- RIGHT: Make a decentralized web application in 5 minutes (or however it's worded) > link to Web5 SDK tutorial
- Secondary CTAs (important pieces of content)
- Idea 1: "Join us in Discord"
- Idea 2: Contribute! > link to contribute page
- Idea 3: Source code > link to github
- Idea 4: Event Calendar or Blog
- Others to be determined by content inventory
- Tertiary CTAs (Component project documentation)
- (Editorial note: to be determined)
- Maybe: Use Case
- Maybe: Projects? SSI and DWN
- Maybe: Tutorials (index of them)
- Twitter, Discord, Github etc links
# Contributing
### See template for a rough draft and more notes...example: https://refine.dev/docs/contributing/
- For contributing to all TBD ecosystem projects, incl. docs. It's where we establish uniformity in contribution experience across Web5, tbDEX, SSI, DWN, etc.
- OSE to standardize around label set which Programs/DevRel can pull to show good first issues
- How about a "contributing" channel on Discord we all (and all project leads) staff and triage to welcome new folks?
- Programs: badges, issue VCs, fire up contributor recognition program
- Example: https://github.com/dayhaysoos/use-shopping-cart at bottom under "Contributors"
# API Reference
Index page with projects listed [here](https://developer.tbd.website/docs/api)

---

# Web5
## Introduction
- Definition of what and why this is - main Web5 messaging
## Quickstart
- Terse explanation of this paradigm - moving to your identity on the internet (DIDs) and how you now own your data (personal data store).
- Installation
- Install: https://www.npmjs.com/package/@tbd54566975/web5
- Using as `<script>` tag in a page
- Standard `npm install`
- Desktop Wallet (is this install the janky wallet, what are you wanting to explain here?)
## Components
(styling this with boxes)
This section will links to the relevant project pages for these, or links to GitHub if those aren't ready for publish.
- SSI
- DWN
- web5-js-sdk
### tbDEX
- ...when available, would live here
- A primary application atop the Web5 Platform
## DIDs
- What is a DID?
- Diagram of it
- Why does someone need one?
- How to get one?
- How to make one? Code Snippet needed
- Where will it be stored? DWN's explained?
- Now that I have it, where can I use it? Talk about current and future use case examples
- Advanced topics:
- ION vs other networks. And why we're choosing ION
- Keytypes?
- Private and Public key swopping?
- What else?
## Interacting w/ a Personal Data Store (Shorter: "Storage"?)
- Introducing this concept
- What else?
## Portable data - Common data between applications and an example (Shorter: "Portable Data")
- Introducing this concept
- Diagram of this new paradigm
- Example: https://schema.org/MusicPlaylist
## How to package your app as a PWA (Shorter: "PWA")
- Is this a tutorial? What is this?
## Needs to get remote comms (Shorter: "Remote Comms" what does that even mean)
- Tenant gating (people can't bomb the DWN servers)
- Limits on account storage (so people can't store unlimited bytes)
- Remote can be done with additional installation and hosting requirements - user installs a DWN somewhere public
- But the no-installation experience is gonna take OSE:
- To spin this off and return to it by end of week - see if we can assemble a jank remote capable solution with no installation requirement for the user
## Use Cases ([example](https://developer.squareup.com/docs/release-notes))
# Projects (or APIs?)
## SSI
### Introduction
- Definition of what and why SSI exists - problem it solves - Difference between SDK and SSI.
### Quickstart
- [Installation](https://github.com/TBD54566975/ssi-service)
- Create a DID
- Create Schema
- Create Manifest
- Issue a Verifiable Credential (add the [playground](https://tbd54566975.github.io/web5-components/demo/VerifiableCredential/) to top side of this section)
- Revoke Credential
- Initiate a Presentation Exchange
- [Contributing](https://github.com/TBD54566975/ssi-service/blob/main/CONTRIBUTING.md) (Do we want this here / for every project or just a whole platform contributing file up top?)
### Components
- Ecosystem (open to another name more fitting)
* Issuer
* SSI Tooling
* Verifier
* SSI Tooling
* Holder
* Wallet/Agent
- Features (open to another name more fitting)
* DIDs
* Verifiable Credentials
* Presentation Exchanges
### Tutorials
- Manually Issue a Credential
- Initiate a Presentation Exchange

# Content Inventory
- These get their own section at the bottom of the Navbar
## Sample Apps
- Index page of all sample apps
## Glossary
## Release Notes