WikiNodes

We are at a very early stage of development, nothing to see here beyond this README. 😊

WikiNodes is a project designed to bring the fork/diff/merge topology popularized by git/hub into the space of private collaboration. A user may, for example, add their life's work to their WikiNodes running on their local Holochain, and privately share any nodes or collections with users or groups they select. Users can then fork each other's nodes, and merge in changes from other users' forks.

Use Cases

• Collaborating around solving problems
• Forking wikipedia (e.g. adding pages that have been deleted by gatekeepers)
• Forking scientific papers
• Differentiating, rating, and merging solutions to global challenges
• Collaborative content creation (e.g. pages, courses and learning materials)
• Forking the best collections assembled by others
• Sorting and graphing content relationships based on trust or semantic tagging
• Better system for collecting bookmarks, research, etc

Features

Creating Pages

• Pages can be imported from other wikis, or uploaded from local files
• Any creative commons (CC-BY-SA) licensed page from any existing site may be forked into, and modified within, WikiNodes

Collections

• User can group Pages (and other Files) into collections
• Collections may differ across users and branches
• A collection is technically a File (JSON or NDJSON)
• Collections can be forked and branched like other Files
• Collections can contain other collections, to any level of nesting (cyclic nesting is ignored)

Groups

• Default group for self - only you
• Default group for all app users
• Can create n groups with specific users
• Creator of groups has admin role
• Admins can give admin to other users
• Admins can add and remove (non-admin) users from groups

Sharing Pages & Collections

• User can share pages/collections with user or group
• Technically, any sha

Forking

• Any user can edit (fork) any page they are able to view
• Forker chooses visiblity of their fork:
  • public
  • network (all upstream/downstream authors who can see this collection)
  • upstream (author of forked page)
  • group of your choice
  • private

Branches

• User can create branches to organize their work
• Branches may diverge from each other, and may fork off any point in any other branch, belonging to same or different user

Merging

• Users can choose to merge changes from any other branch, theirs or otherwise, into any of their branches

Trust Network

• Cascading trust graphs allow users to filter what they see, eliminating spam and abuse

Bonus Feature: Realtime Collaboration

• A user can share a link with friends/colleagues, to create a realtime collaboration session, which writes to a single fork, owned by the originating user

Architecture

DHTs

• The app has a DHT for coordination
• DHT per group, for sharing content -- this is invite only via code
• DHT for content shares with all users of app
• DHT for public content

Collaboration

• We integrate Syn for realtime collaboration features
  • Possibly every edit, or major edits, or checkpoints, are spit out as Page Versions
• For reputation, we use one or both of Trust Graph (shown in diagrams) and/or Sacred Capital.

Correspondence to Git Concepts

WikiNodes	Git
Collection	Repo
Branch	Branch
File Version	Commit (to a single file)
Tag	Tag
File	File in non-bare repo

---

title Data Model
hide circle
skinparam linetype ortho

entity User {
    id: <<public key>>
}

entity Group {
    admins: <<public key>>[]
    members:  <<public key>>[]
}

entity Branch {
    name: String
}

entity Tag {
    content: String
}

entity "File Version" {
    id: <<content hash>>
    content: Byte[]
    metadata: Dictionary
}

entity "File View" {
    Examples:
    - Rich Text
    - Media
    - Collection
    ---
    id: <<uuid>>
}

"File Version" ||--o{ Tag
User }--{ Group
User ||--o{ Collection
Collection ||--{ Branch
Branch ||--{ "File Version"
"File View" ||--{ "File Version"

---

title Single Level Trust Graph

hide circle
skinparam linetype ortho

entity Viewer {
    id: <<public key>>
}

entity User {
    id: <<public key>>
}

entity Rating {
    source: <<public key>>
    target: <<public key>> or <<content hash>>
    value: 0..1
    content: String
}

entity "File Version" {
    id: <<content hash>>
}


Viewer ||--o{ Rating: //source//
Rating ||--o| "File Version": //target//
Rating ||--o| User: //target//

---

title Multi Level Trust Graph

hide circle
skinparam linetype ortho

entity Viewer {
    id: <<public key>>
}

entity Reviewer {
    id: <<public key>>
}

entity "Level 1 Rating" {
    source: <<public key>>
    target: <<public key>>
    value: 0..1
    content: String
}

entity "Level 2 Rating" {
    source: <<public key>>
    target: <<public key>> or <<content hash>>
    value: 0..1
    content: String
}

Viewer ||--o{ "Level 1 Rating": //source//
"Level 1 Rating" ||--|| Reviewer: //target//

Reviewer ||--o{ "Level 2 Rating": //source//
"Level 2 Rating" ||--o| "File Version": //target//
"Level 2 Rating" ||--o| User: //target//