Skip to content

Commit

Permalink
feat: Added category indexes as README.md and expanding the documen…
Browse files Browse the repository at this point in the history
…tation home page
  • Loading branch information
CMCDragonkai committed Nov 8, 2022
1 parent ceb6302 commit ef9b215
Show file tree
Hide file tree
Showing 10 changed files with 142 additions and 44 deletions.
78 changes: 78 additions & 0 deletions docs/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,78 @@
---
slug: /
displayed_sidebar: docs
---

# Polykey Documentation

Welcome to the Polykey documentation.

The documentation is structured using [Divio system](https://documentation.divio.com/).

* [Tutorials](./tutorials/) - these are a series of steps to introduce Polykey to new beginners to achieve a practical outcome
* [How-To Guides](./how-to-guides/) - these are short guides on how to achieve a specific use-case which makes assumptions on the reader
* [Theory](./reference/) - these are important for understanding the "why" of Polykey
* [Reference](./reference/) - these are useful when you need remember how to use a particular command or function

Check out [Getting Started](./tutorials/getting-started.md) to deploy your first Polykey node.

<img src="/images/divio_quadrant.png" width="100%" />

## Introduction

Polykey helps yourself, teams and software agents to manage and share secrets in a secure and easy-to-use manner.

* Usable for average humans, you don't need to be a cryptography or cybersecurity expert to securely manage and share secrets.
* Can be integrated into software for automation of secret workflows.
* Unifies the workflow between interactive password management and infrastructure key management.
* Decentralized and local-first software that does not hand over your secrets to the cloud. You maintain sovereignty over your secrets on your devices.
* Easily backup and synchronise your secrets across all your devices: desktop, mobile or server.
* End to end encryption for all network communication.
* All data is encrypted at rest, thus preventing compromise even if devices are lost or stolen.

PolyKey is an open-source decentralised peer to peer secrets management system. It provides a software agent that runs on your device locally. Each agent process is a node in the Polykey peer to peer network. This agent manages your secret data and is capable of sharing secrets with other trusted Polykey agents. The secret data can be placed inside any directory on your computer including on USB storage.

## Features

TBD

## Principles

There are 2 main concepts to understand in Polykey:

* Secrets Management
* Decentralized Trust

### Secrets Management

Polykey was built from the ground up to focus on secrets management.

Secrets can be any kind of data that enables some sort of capability in the physical or virtual world.

The world is full of secrets. For example, a password is a secret that enables you to login to a website. A private key is a secret that enables you to sign and verify some data. A symmetric key is a secret that enables you to encrypt and decrypt some data. A token is a secret that enables software agents and machines to authenticate to remote services. A credit card is a secret that enables payments.

Polykey is designed to manage all kinds of secrets. It is not limited to passwords or keys.

For this reason, we think of secrets as "capabilities".

All secrets put into vaults. Each vault is a persistent fully-encrypted virtual filesystem with automatic version history. Vaults can be shared with other Polykey agents.

Polykey's secrets management concept provides users with secure commuication and secure computation.

### Decentralized Trust

Sharing secrets depends secure communications. Secure communications depends on trusted identities.

Polykey introduced a concept called "Gestalt Identity".

A Gestalt Identity is a collection of digital identities (social media profiles and Polykey nodes) that all represent the same entity.

When you start a Polykey agent, it immediate forms its own gestalt with the Polykey node as its only identity. Link up your digital identities to the node in order to expand your gestalt.

As you deploy more Polykey agents, you can join existing gestalts.

Your gestalt is how other users are able to share secrets with a trusted identity. Your identity is the sum of the reputation of all your digital identities that are part of the gestalt.

## Comparison to other Tools

TBD
5 changes: 5 additions & 0 deletions docs/development-guide/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
import DocCardList from '@theme/DocCardList';

# Development Guide

<DocCardList />
41 changes: 0 additions & 41 deletions docs/home.md

This file was deleted.

5 changes: 5 additions & 0 deletions docs/how-to-guides/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
import DocCardList from '@theme/DocCardList';

# How-To Guides

<DocCardList />
5 changes: 5 additions & 0 deletions docs/reference/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
import DocCardList from '@theme/DocCardList';

# Reference

<DocCardList />
5 changes: 5 additions & 0 deletions docs/theory/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
import DocCardList from '@theme/DocCardList';

# Theory

<DocCardList />
5 changes: 5 additions & 0 deletions docs/tutorials/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
import DocCardList from '@theme/DocCardList';

# Tutorials

<DocCardList />
15 changes: 15 additions & 0 deletions docs/tutorials/installation.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# Installation

Polykey is a set of open source packages:

* [Polykey Core Library](https://github.com/MatrixAI/Polykey)
* [Polykey CLI](https://github.com/MatrixAI/Polykey-CLI)
* [Polykey Desktop](https://github.com/MatrixAI/Polykey-Desktop)
* [Polykey Mobile](https://github.com/MatrixAI/Polykey-Mobile)

## Polykey Core Library

The Polykey core library


### Requirements
4 changes: 2 additions & 2 deletions docusaurus.config.js
Original file line number Diff line number Diff line change
Expand Up @@ -83,9 +83,9 @@ const config = {
items: [
{
type: 'doc',
docId: 'home',
docId: 'README',
position: 'left',
label: 'Home',
label: 'Docs',
},
{
href: 'https://github.com/MatrixAI/Polykey-Docs',
Expand Down
23 changes: 22 additions & 1 deletion sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -7,14 +7,23 @@ const sidebars = {
type: 'category',
label: 'Tutorials',
collapsed: false,
link: {
type: 'doc',
id: 'tutorials/README',
},
items: [
'tutorials/getting-started'
'tutorials/installation',
'tutorials/getting-started',
]
},
{
type: 'category',
label: 'How To Guides',
collapsed: false,
link: {
type: 'doc',
id: 'how-to-guides/README',
},
items: [
{
type: 'category',
Expand Down Expand Up @@ -55,6 +64,10 @@ const sidebars = {
type: 'category',
label: 'Theory',
collapsed: false,
link: {
type: 'doc',
id: 'theory/README',
},
items: [
'theory/secrets-management',
'theory/decentralized-trust-network',
Expand All @@ -66,6 +79,10 @@ const sidebars = {
type: 'category',
label: 'Reference',
collapsed: false,
link: {
type: 'doc',
id: 'reference/README',
},
items: [
{
type: 'category',
Expand Down Expand Up @@ -192,6 +209,10 @@ const sidebars = {
type: 'category',
label: 'Development Guide',
collapsed: false,
link: {
type: 'doc',
id: 'development-guide/README',
},
items: [
'development-guide/roadmap',
'development-guide/software-architecture',
Expand Down

0 comments on commit ef9b215

Please sign in to comment.