first commit

0_overview/1_getting_started.md

@@ -0,0 +1,11 @@
+To use the AO, you must have an account.
+
+1. Someone else will need to create an account for you and tell you the URL, your username and password so you can log in.
+
+2. Visit the URL and type the username and password and press Enter to log in.
+
+When you first log in, there will be a big, rainbow button that says "**Take Tour**" in the lower left of the page. Click this to take an introductory tour of the AO.
+
+The default password for new AO accounts is the same as the username.
+
+Planned feature: The ability for anyone to create a new account on the AO, without having to be invited.

0_overview/2_parts_of_the_screen.md

@@ -0,0 +1,11 @@
+The page is divided up into a few main parts:
+
+- The buttons around the edge of the page open different panels
+
+- The current card is at the center of the page, and the context history is above it
+
+- Your member card is always the top card of the context history
+
+- The bookmarks bar is at the bottom center of the page
+
+- The main menu is the three dots menu in the lower right corner of the screen.

0_overview/index.md

@@ -0,0 +1,13 @@
+---
+title: Overview
+---
+
+The AO is a free software project and a lived practice of creating open-source software for an online-and-offline peer-to-peer community.
+
+AO stands for **Autonomous Organization**. The AO seeks to distribute power informally by teaching new users how to set up and administer an AO server. This is similar to DAOs, but we have dropped the 'D', which stands for "Decentralized", because the AO does not use blockchain technology for community functions and is technology-agnostic.
+
+The AO is not just software. The AO is a distributed, agile, flocking organization made up of everyone who uses the AO software or enacts the liberatory peer-to-peer principles of the AO in their dealings with others.
+
+Each new person who discovers the AO has their own desires, feature requests, and big ideas. The AO includes the entire process of bringing in new community members, teaching them how to use the software, and improving the software based on requests from the new community member.
+
+For developers, the AO provides a free and standards-focused digital space, as well as a suite of task-management tools for improving the AO in collaboration with other AO developers.

10_hardware/index.md

@@ -0,0 +1 @@
+To access hardware resources connected to the AO, click the icon in the top-right corner of the screen.

11_installation/1_ao-cli.md

@@ -0,0 +1,108 @@
+---
+title: ao-cli
+---
+
+ao-cli will do all the below stuff so it will be able to be removed from the manual soon.
+
+The AO comes with a comprehensive install script, just download and run it and it will do everything.
+
+1. Open a terminal (in your home directory).
+
+2. \`wget https://raw.githubusercontent.com/coalition-of-invisible-colleges/ao-react/master/install.sh\`
+
+3. \`chmod +x install.sh\`
+
+4. \`./install.sh\`
+
+5. Wait for installation to finish. It may take 15 minutes or up to several hours on slower computers.
+
+Now, you must delete the autogenerated configuration.js file and run the install script a second time to regenerate it. (Do not delete your configuration.js file if you have already customized it!)
+
+1. \`rm ~/ao-react/configuration.js\`
+
+2. \`./install.sh\`
+
+The second time you run the AO install script, it should say "already installed" for everything. If it doesn't, please tell an AO dev so they can update the install script.`, 'Configuring the AO': 'How to set up your configuration.js file and .env file. Sane defaults to be provided here.', 'Setting up nginx': `If you are running your AO on your own computer for personal use, you might not need to set up nginx. However, if you want your AO to be accessible from another computer, set up nginx to allow outside connections to be proxied to the AO.
+
+The AO install script will install nginx, or you can install it yourself.
+
+Create a file for each website you want to host with nginx in /etc/nginx/sites-available/, and then use ln -s <source> <destination> to create a symbolic link to the configuration file in /etc/nginx/sites-enabled/.
+
+Here is an example configuration file from DCTRL:
+
+map $http_upgrade $connection_upgrade {
+default upgrade;
+'' close;
+}
+
+server {
+server_name ao.dctrl.ca;
+
+        root /home/dctrl/ao-react/dist/;
+
+        location / {
+    index index.html index.htm index.nginx-debian.html;
+    try_files $uri $uri/ =404;
+
+}
+
+       location ~ ^/(login|task/) {
+                try_files /index.html =404;
+        }
+
+        location ~ ^/(logout|meme|memes|events|search|session|state|upload|download|fetchTaskByID|fetchTaskByName) {
+    proxy_pass http://127.0.0.1:8003;
+
+}
+
+        location /socket.io {
+    proxy_pass http://127.0.0.1:8003;
+    proxy_http_version 1.1;
+    proxy_set_header Upgrade $http_upgrade;
+    proxy_set_header Connection $connection_upgrade;
+    proxy_set_header Host $host;
+        }
+
+listen [::]:443 ssl ipv6only=on; # managed by Certbot
+listen 443 ssl; # managed by Certbot
+ssl_certificate /etc/letsencrypt/live/dctrl.ca/fullchain.pem; # managed by Certbot
+ssl_certificate_key /etc/letsencrypt/live/dctrl.ca/privkey.pem; # managed by Certbot
+include /etc/letsencrypt/options-ssl-nginx.conf; # managed by Certbot
+ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem; # managed by Certbot
+}
+
+server {
+if ($host = ao.dctrl.ca) {
+    return 301 https://$host$request_uri;
+} # managed by Certbot
+
+listen 80 default_server;
+listen [::]:80 default_server;
+server_name ao.dctrl.ca;
+return 404; # managed by Certbot
+}`, 'Setting up file hosting': `When the AO starts, it scans the ~/.ao/memes folder for files. It hashes each file and checks to see if a card with that hash already exists. If not, it creates it.
+
+When users drop a file on an empty grid square, it will be uploaded to this directory and linked with a new card via the file's hash. The text of the card will be the filename of the uploaded file.
+
+In configuration.js, there are four configuration options related to files:
+
+- dir: The directory of the memes folder to scan, by default ~/.ao/memes
+
+- sshKey: The path to the id_rsa file for the ssh key to use to connect to other AOs for rsync-based filesharing
+
+- sshUsername: The username to use for the ssh key
+
+- videoCacher: The path to to the youtube-dl executable/bin file
+
+For example:
+
+memes: {
+dir: '/home/dctrl/.ao/memes',
+sshKey: '/home/dctrl/.ao/id_rsa'
+sshUsername: 'doge',
+videoCacher: '/usr/bin/youtube-dl',
+},`, 'Setting up filesharing over Tor': `You must create an SSH key using ssh-keygen (or use an existing key you have) to use the AO's automatic fle attachment synchronzation feature. See the previous section for the configuration options to set with the path to your SSH key.
+
+You must also use ssh-copy-id or edit the known_hosts file on the other computer in order to give this AO access to the other one via SSH, for copyng files with rsync.`,
+'Setting up Signal Notifications':
+'The AO install script will soon install signal-cli automatically, or the AO will include a Signal library that does not need to be compiled separately. Compiling signal-cli yourself is a pain and not recommended, since the pieces must be compiled separately and the broken installation scripts modified by hand.',

11_installation/index.md

@@ -0,0 +1 @@
+Instructions from scratch for installing the AO on various platforms

12_administration/1_connecting_hardware.md

@@ -0,0 +1,35 @@
+---
+title: Connecting hardware resources
+---
+
+The AO can connect over a wired LAN or wifi to control the GPIO pins on a raspberry pi. This allows hardware peripherals to be connected to the AO, controlled by members, and restricted with a fee or to active members.
+
+To use a hardware resource with the AO, it must be connected, and a custom control panel GUI must be written for it to display in the Resources panel.
+
+To set up the RFID fob:
+
+1. Plug in your RFID reader device
+
+2. Find the name of the hardware by finding where your OS has its hardware devices, and save this info for the init process (type it exactly)
+
+3. Do gpio-export (there are two different numbering systems for the pins)
+
+8 . Set it up to autostart with systemctl
+
+To connect a hardware resource to the AO via a Raspberry Pi:
+
+1. Install an OS on your Raspberry Pi (we suggest Debian).
+
+2. git clone https://github.com/AutonomousOrganization/pi
+
+3. cd pi
+
+4. npm i
+
+5. Create a user on your AO for the hardware resource to use (or use an existing user)
+
+6. npm run init
+
+The AO connect script on the pi will log into the AO as the user and use that access to trigger resource-used events on the server.
+
+GPIO has two modes: BCM and 'board'. For 'board', the order is the physical order of the pins themselves. BCM stands for Board Control Module, and the order is the logical order of the pins.

12_administration/2_p2p.md

@@ -0,0 +1,5 @@
+---
+title: Connecting two AOs
+---
+
+How to connect two AO's p2p over Tor

12_administration/3_file_hosting.md

@@ -0,0 +1,5 @@
+---
+title: Adding files serverside
+---
+
+The AO allows users of the website frontend to drag-and-drop files onto a grid to upload them. However, if you install the AO on your laptop or on a server, you can add files directly to the AO by putting them in the AO's memes folder. The default location of this folder is \~/.ao/memes/. Simply copy or move files here and restart the AO, and the files will be scanned and a card made for each file. These cards are not held by anyone right now, so you must search for them and grab them to find them. Future updates will also add live scanning and full iTunes-like file organization features, so that your folders of memes on your hard drive can be kept in lockstep with the structure of your cards on the AO.

12_administration/4_snapshots.md

@@ -0,0 +1,5 @@
+---
+title: Snapshots for Faster Server Start
+---
+
+In its database, the AO uses a log of events from the beginning of time to reconstruct the current state of affairs every time it starts up. The AO can also make snapshots of the state of affairs at a particular point in time and load from one of these images when it starts up. Currently, the recommended normal operation of the AO is to set the AO to automatically make these snapshots once per day, and to always load from the most recent snapshot. When a snapshot is created, in theory, all of the events preceding that snapshot could be safely deleted, as the AO will always be able to load from the snapshot. However, this is not yet recommended, because the AO is not yet fully stable, and if you run into any issues with your snapshots, you can always just reconstruct from the beginning of time. Later, we may set it to automatically delete the old events, which will allow the AO to fully forget deleted cards and members. Currently, traces still remain in the database and are accessible to admins (or an attacker).

12_administration/5_updating.md

@@ -0,0 +1,12 @@
+---
+title: Updating an AO server
+---
+
+ao-cli will do a better job of this automatically soon.
+
+to update the AO:
+cd ao-react
+git pull --rebase
+npm i [if package.js or package-lock.js has changed]
+npm run webpack [if anything on the client such as components have changed]
+sudo systemctl restart ao [if anything on the server has changed]

12_administration/6_security.md

@@ -0,0 +1 @@
+The AO has not been adequately secured, tested or vetted and is not secure. It is not recommended to use the AO for storing private information. However, the AO has been made with modern web technologies in a fairly standard way, so in theory it should be "secure by default" to most common attacks.

12_administration/index.md

@@ -0,0 +1 @@
+For admins

13_dev/1_roadmap.md

@@ -0,0 +1,13 @@
+Here is a roadmap of the next few versions of the AO:
+
+- AO version 0.8.0 will bring back bitcoin and lightning integration.
+
+- AO version 0.9.0 will finalize task completion, timeclock, and bounty features.
+
+- AO version 1.0 Alpha will finalize all existing features and freeze the feature set for the 1.0 release.
+
+- AO version 1.0 Beta will polish all features and fix all bugs
+
+- AO version 1.0, codename "Shrigma", will be complete
+
+- AO version 1.1 will add important convenience features such as the ability for end-users to export their cards for download, sound effects, and better theming.

13_dev/2_components.md

@@ -0,0 +1,5 @@
+---
+title: Components Guide
+---
+
+Describe, visualize and name every component

13_dev/3_help.md

@@ -0,0 +1,5 @@
+---
+title: How to Help
+---
+
+Please contact an existing developer to request an account at ao.coalitionofinvisiblecolleges.org, where ao-react development goals are currently being organized.

13_dev/index.md

@@ -0,0 +1,5 @@
+---
+title: Development
+---
+
+If you are a software developer, you can help improve the AO! Some AO developers volunteer, and others opt to claim bounties put up by hackerspaces who want to see the AO improved. Either way, we would realy appreciate your help! You can join us at ao.coalitionofinvisiblecolleges.org.

14_philosophy/1_desert_power.md

@@ -0,0 +1,19 @@
+Desert power is the capability of the autonomous to enhance itself.
+
+The AO becomes a self-improving system insofar as we build patterns that enable the AO to improve itself. As users and developers, we can test and dogfood the AO and improve how well it works for planning and developing improvements to the AO itself. In this way, we optimize our own development and communications process by optimizing the AO's ability to self-modify.
+
+Here are some things that the AO would have no trouble doing if it were a nomadic war machine:
+
+- Use the AO to install the AO
+
+- Use the AO to get tech support for the AO
+
+- Use the AO to communicate with other AO users
+
+- Use the AO to communicate with other AO users about desired AO upgrades
+
+- Use the AO to make decisions about planned collective actions with other AO users
+
+- Use the AO to plan an upgrade to the AO
+
+- Use the AO to communicate with other devs and run a sprint to upgrade the AO

14_philosophy/2_praxis.md

@@ -0,0 +1,7 @@
+Praxis means practice (Greek <a href="https://www.etymonline.com/word/praxis#etymonline_v_18617">etymology</a>). Praxis is about putting things into practice, walking the walk, practicing what you preach. The opposite of praxis is sedentary hypocrisy.
+
+Praxis is also about practicing, over and over. Trying things out for yourself and seeing if they work. Not giving up right away, or maybe ever.
+
+Nothing will get done if nobody does anything. Praxis is doing the thing instead of just talking about doing the thing.
+
+**Doing. Getting it done.**

14_philosophy/3_immediacy.md

@@ -0,0 +1,7 @@
+_Go for the low-hanging fruit._
+
+Immediate is the opposite of mediated.
+
+### Ease
+
+Computers and other technology should make our lives easier, not harder. As an end-user I want everything to be free and easy. As a developer, I fix all the easy bugs first and work outward from there, looking for the task that will have the greatest positive impact on the AO's desert power. Efficiency thus becomes a practice of ease and pleasure and not asceticism.

14_philosophy/4_unmanageability.md

@@ -0,0 +1,3 @@
+_Take chances, make mistakes, get messy!_
+
+The AO helps its users to become unmanageable, and the AO also eschews top-down models of card management as much as possible, while still providing convenient ways to organize cards. The AO user interface is designed to make interaction with the computer safe and to make it impossible to accidentally delete cards or leak private data.

14_philosophy/5_unscalability.md

@@ -0,0 +1 @@
+The AO is not designed to be highly scaleable. Dunbar's number is 150 and large groups are toxic. Instead, the AO is designed to empower individuals and small groups, and make it easy to fork and administer one or several AOs. This increases the number of users capable of administering an AO, whereas a model that places scalability as first priority is designed to handle a large number of inept users on one platform provider's service. This runs contrary to the peer-to-peer and community educational functions of the AO.

14_philosophy/6_unmodularity.md

@@ -0,0 +1,5 @@
+The AO is a standards- and consensus-building project amongst the many projects of the free software / open source communities. Often, when projects decide to add a plugins or modules functionality, it is because the devs are unable to agree on what is essential, and/or are attempting to farm additional labor from an alienated plugins dev community.
+
+The AO is a project to integrate the many existing and working useful open-source projects into one (or a few) usable end-products that are useful for specific users for specific use-cases. These use-cases are things we're all familiar with, that we all want to do with our computers, such as taking notes, planning a todo list, or sharing a photo album privately with a group of people. There are really not that many of these core features, and they are simple enough that we all want mostly the same functionality.
+
+However, the AO will eventually add a modules feature and it will be glorious. Something that will make the AO's modules different from other plugin systems, such as Firefox's Add-ons, will be that AO modules will be able to require dependencies in sequence. All current AO modules will be part of one sequence, such that when all modules are activated, the sequence is included and activated within the AO in the same order. That is because choices to include features are hierarchical and also represent living user communities forking or merging.

14_philosophy/7_minimalism_atomicity.md

@@ -0,0 +1,9 @@
+---
+title: Minimalist atomicity
+---
+
+_The steps you take don't have to be big, they just have to take you in the right direction._
+
+Atomic operations are those that either succeed or fail, with no partial failure states or error modes. Minimalism attempts to reduce design and action to its bare essentials or smallest gesture.
+
+Therefore, atomic minimalism is an approach to improving the AO that attempts to only upgrade the AO from one stable state to a better stable state, without backsliding, introducing new bugs, or losing features. Moreover, atomic minimalism attempts to make the smallest possible useful change to the AO, rather than making a larger and more complex change to the AO.

14_philosophy/8_progress.md

@@ -0,0 +1,13 @@
+The AO is a collaborative project to integrate the most useful open-source software in an accessible way. For the project to develop and become a greater success over time requires:
+
+1. Not backsliding on features: Not losing features and fixing broken features promptly; not letting new features break, replace, or make redundant existing features.
+
+2. Polishing existing features: Fixing bugs with existing features before moving on to new features; continually using the software ourselves and making tweaks.
+
+3. Integrating existing features together: Improving consistency in how features interact functionally, conceptually, and visually and behaviorally in the GUI. Integrating existing features more tightly or inventing a new useful way two features can interact.
+
+4. Adding new features: After fixing bugs, polishing, and integrating existing features as much as possible, add, debug, polish, integrate, and polish the integration of one new feature.
+
+5. Reformatting conceptually: As features are integrated, new paradigms and new ways to combine and conceptualize features together will become apparent. These new concepts will be necessary if the AO is tightly integrated, but if the AO is not well-integrated at the time then adding big new ideas is likely a mistake based on the existing messy concepts. First tighten up the UX logic, then paradigm shift.
+
+The more care and shine is given to existing features and their integration, the more advanced the AO will become as a project overall. Once a certain critical mass of core features is integrated and polished, the AO will be widely adopted.

14_philosophy/index.md

@@ -0,0 +1,9 @@
+---
+title: Philosophy
+---
+
+The AO, ultimately, is a collection of principles about how to develop sofware communally and how to talk about cooperation.
+
+These principles are meant to be modified by the community that uses them, so please take these ideas as evolving and in-discussion. Please propose or make changes to this manual.
+
+**Dissensus-driven development** means that the AO is ultimately a conversation between the AO developers and AO users / user community. The AO ought to be designed with ongoing conversation amongst everybody who will come to the table and join the design process. The goal is to integrate the design process with the community's goals and the individual self-expression of users, by continuing the conversation. Consensus-driven development is good, but dissensus-driven development goes beyond that to include negotation across and through differences and conflict in the design process. By continuing the conversation, we can all gradually agree more about how to organize the AO to meet the needs of an ever-boader audience.

15_tech_support/index.md

@@ -0,0 +1,7 @@
+This user manual contains a mostly complete description of the AO's functionality and many of its known bugs. If you need more help, or if something is missing from the manual, please let us know.
+
+You can contact the AO developers by leaving a card on the AO at ao.coalitionofinvisiblecolleges.org. This AO is not yet open-registration but will be soon.
+
+In the meantime, you can make an issue on GitHub at https://github.com/coalition-of-invisible-colleges/ao-react/issues.
+
+Planned features: One-click tech support button that makes a card on the devs' AO via tor. One-click phone support button that automatically calls tech support volunteers over VOIP until one picks up (or uses a smartclock to choose someone who can answer). OpenAO feature for public account registration, so that anyone can join ao.coalitionofinvisiblecolleges.org.

1_cards/1_deck.md

@@ -0,0 +1,21 @@
+---
+title: Your deck of cards
+---
+
+Each member has a deck of cards on each AO server that they have an account on. You can view and search all of the cards in your deck by clicking the icon to the right of the bookmarks bar, along the bottom edge of the screen.
+
+### Grabbing a card
+
+If you see a card you like and want to save, you can grab it and add it to your deck by clicking the Grab icon (by default, an icon of hand grabbing a card) on the card. Cards in your deck cannot be deleted by other members—cards that are held by nobody may be cleaned up every 5-10 minutes.
+
+### Finding lost cards
+
+While moving and discarding cards on the AO, sometimes cards get lost or misplaced. Click the Lost Cards tab in Deck sidebar to see your lost cards. It shows five lost cards at a time; drag cards out to sort them and see more lost cards.
+
+The guild cards in your deck are the root categories into which cards are sorted. A card in your deck is considered lost if it cannot be found in one of your guilds, or in a card within those guilds (you must also be holdng all the cards in between).
+
+Your deck can be thought of like a deck of a ship, with your guilds making up the different functional compartments of the ship. Any cards that fall overboard as flotsom are considered "lost cards" and sink down to the lost cards archive.
+
+Your options for how to handle a lost card so it is no longer in the lost cards list: Sort it into a guild or card within a guild card in your deck; upgrade the card or its parent card to a guild; grab its parent card (e.g., if it's a guild you aren't holding); drop or delete the card.
+
+Sometimes, cards lower on the lost cards list are within cards higher on the list, and so when you sort the first card, the card inside will also no longer be lost.

1_cards/2_navigating.md

@@ -0,0 +1,7 @@
+---
+title: Navigating within a card
+---
+
+Cards can contain other cards within them.
+
+1. Click a card to navigate to it and see what's within it.

1_cards/3_zones.md

@@ -0,0 +1,37 @@
+---
+title: Zones of a card
+---
+
+Each card has four zones where other cards can be placed: the priorities, the pyramid or grid, the stack below the grid, and the accomplishments.
+
+### Priorities
+
+Prioritized cards appear in a stack just after the content of the card, but before any other content, so you can focus on the priorities first.
+
+If this stack has more than one card in it, a number will display below the stack of the number of hidden cards. Click this number to show the other cards in the stack.
+
+To prioritize a card, drag it to the priorities area, or if the card has a boat icon in its top-right corner, clicking that will prioritize it. Cards will also be added to the priorities list when they are dropped within the card.
+
+If the list of priorities has more than 6 items in it, a button that says "Refocus" will appear. Click this button to dump all priorities back down to the other stack of cards below.
+
+The number of priorities within a card displays on the front of the card, followed by an exclamation mark. For example, a card with three priorities will display a small "3!" on its face. Click this number to toggle priority mode. While in priority mode, the first priority of a card will display in front of that card on the grid. This allows you to see your next actions even in nested subprojects. (See also Productivity->Priority mode)
+
+To re-prioritize a card to the top of the priorities, drag and drop a card onto the priorities stack.
+
+### Pyramid / Grid
+
+After the priorities, an optional grid or pyramid can be added to a card. A grid has squares that other cards can be dragged and dropped on. To add a pyramid to a card, click the card's menu (three dots in lower right of card), then click "Add pyramid". To change it to a grid, click the small triangualur menu button in the lower right corner of the pyramid, then click Grid in the popup menu that appears. In this menu, you can also increase and decrease the size of the grid squares.
+
+To resize a pyramid or increase the number of rows a grid has, click the horizontal +/- button below the grid. To increase the number of columns a grid has, click the vertical +/- buttons to the right of the grid. If you use these buttons to shrink a pyramid or grid to one row (or column), a "-grid" button will appear which allows the grid to be removed.
+
+When a grid is shrunk, any cards that no longer fit will be harmlessly dumped to the stack below the grid.
+
+### Subcards
+
+Other cards that are not prioritized and not placed on the grid accumulate in the stack below the grid. To move a card to the top of the subcards stack, drag and drop a card onto the stack.
+
+### Accomplishments
+
+The Accomplishments icon appears in the lower left corner of the card when a card contains at least one completed card. When you discard a card from another card, if that card has at least one checkmark, it is moved to the Accomplishments section instead of being discarded. This allows you to collect accomplishments wthout having to think about it.
+
+Click the Accomplishments icon to show the completed cards within a card. If you want to remove a card from the Accomplishments section, drag it and drop it to the background of the page.

1_cards/4_moving_discarding.md

@@ -0,0 +1,9 @@
+---
+title: Moving & discarding cards
+---
+
+Use drag-and-drop to move cards around. You can drop cards to squares on the grid, or to the priorities stack or subcards stack within a card (above and below the grid, respectively).
+
+### Discarding cards
+
+You can drop cards onto the black background and they will be discarded from the current card. Discarding will not delete the card, just remove it from its present location. You can drag on the black background itself to grab the most recently-discarded card back (it remembers all the cards you discard locally until you refresh the page).

1_cards/5_search.md

@@ -0,0 +1,9 @@
+---
+title: Searching for cards
+---
+
+To find a card you are looking for, you can use the search box.
+
+1. Click the Search icon in the button left corner of the page, then type what you are looking for in the search box.
+
+The AO's search uses regular expressions, a powerful way to format your searches. For example, to search for all cards on the server, search for ".\\\*" (period asterisk). For more information on regular expressions, try this [quick start tutoral](https://www.regular-expressions.info/quickstart.html) or this [cheat sheet](http://stanford.edu/~wpmarble/webscraping_tutorial/regex_cheatsheet.pdf).

1_cards/6_gifts_inbox.md

@@ -0,0 +1,16 @@
+---
+title: Sharing & receiving cards
+---
+
+There are two ways to send a card:
+
+1. Drag the card over the Members icon on the left edge of the page. The member sidebar will open. Drop the card on the member you want to send it to.
+
+2. After you grab a card, an icon will appear in the top-left corner of the card. Click this icon, type a member name, and press Enter to send this card to another member on this server.
+
+You can tell a card was sent by hovering on the pin on the card's top-left corner. The tooltip will display a list of pending card gifts that have not yet been opened. The subscript number on the pin is the number of pending sends.
+
+### Receiving a card
+
+When someone sends you a card, it will appear in a giftbox on your member card. Click it to open the gift and put the card in your member priorities. This will add the card to your deck; discard the card to send it to your archive, where it can be deleted (feature coming soon).
+Planned feature: Ability to open a gift without accepting it yet (was previously possible)

1_cards/7_bookmarks.md

@@ -0,0 +1,11 @@
+---
+title: Bookmarking cards
+---
+
+You can drop cards on your dock aka bookmarks bar at the bottom center edge of the screen.
+
+You can resize the bookmarks bar by clicking the +/- buttons on its right edge.
+
+This is just a normal grid on a reserved card that is named based on your memberId (normally hidden, you can see it in the address bar on your home card—search it to find your bookmarks card).
+
+This feature might not be included in ao-svelte.

1_cards/8_hub.md

@@ -0,0 +1,9 @@
+---
+title: The Community Hub card
+---
+
+There is a reserved card with the text 'community hub' on each server. Click the icon in the top-left corner of the screen to visit this card.
+
+Drop any card onto the hub icon (an icon of a sun, by default) to send it to the priorities list of the community hub card. A badge on the hub icon shows the current number of priorities in the hub card.
+
+Having one card as a shared starting-place for everyone makes it much easier to start sharing cards, memes, and news in smaller communities. The other way to share stuff within a server is guilds.

1_cards/index.md

@@ -0,0 +1,15 @@
+The AO stores a deck of cards for each member on a server. You can put plain text, Markdown, HTML, pasted links, or uploaded files on a card. You can send cards to other members on the same server, or synchronize cards and their attachments with another AO server over Tor.
+
+Each card has a card menu (three dots) allowing you to change the card's color and access other functions of the card.`,
+
+    'Creating a card': `There are two ways to create a card:
+
+1. Click the Compose button at the top of the bookmarks bar (bottom center), type something, and press Enter to create the card. This will create a card within the card you are currently viewing.
+
+2. Click an empty grid square, type something, then press Enter to create the card. This will create a card and place it in that grid square.
+
+The card compose box will remember a draft you are writing. Your draft is stored locally in your browser and also saved on the server.
+
+If you type the text of an existing card, that card will be recalled and played instead of creating a duplicate card. It is impossible to create a duplicate card on the AO.
+
+Planned features: Choose color of card before creating; rich text editing features; ability to create a card already-prioritized; ability to create cards encrypted with the server's private key.

2_productivity/1_checkbox.md

@@ -0,0 +1,7 @@
+---
+title: Checking off tasks
+---
+
+Every card has a checkmark you can check. You must have the card in your deck to see the checkmark.
+
+If a card has a funded bounty on it, you will claim the points when you check it.

2_productivity/2_priority_mode.md

@@ -0,0 +1,5 @@
+If a card has prioritized cards within it, the number of them will show on the front of the card wherever it appears, with an exclamation mark. For example, a card with two priorities within it will display '2!' on its face.
+
+If you click this small number, you will enter 'priority mode'. In this mode, the first priority within a card will show up in front of it (on the grid). This will allow you to see priorities "prior to" the card they are within. This is very useful for seeing the next action within a project. If the first priority also has a priority, that will cover the parent priority, making it easy to find the next action even within a nested subproject.
+
+Priority mode might not make it into ao-svelte.

2_productivity/3_timeclock.md

@@ -0,0 +1,5 @@
+---
+title: Starting the timeclock
+---
+
+Press DO IT next to the first priority within a card to start the timeclock. The task will display the task at the top center of your screen to remind you that you are still working on it. You can use this feature to optimize your time-management through feedback, or to track work or time spent on different projects.

2_productivity/4_hopper.md

@@ -0,0 +1,5 @@
+---
+title: The Hopper
+---
+
+The hopper is a small boat icon at the upper left of your bookmarks bar that allows you to hop between your bookmarks. Hover on the hopper icon to see the options and start hopping.

2_productivity/5_drawpile.md

@@ -0,0 +1,5 @@
+---
+title: Drawing cards
+---
+
+Not sure what to do next? Press the Escape key to go up one card at at time until you clear all the cards. Behind it you will find up to four draw piles plus a Doge that randomly chooses from one of the piles below.

2_productivity/index.md

@@ -0,0 +1,5 @@
+---
+title: Productivity Features
+---
+
+The AO contains all the things you need to track todo lists, organize your life, and get tons done!'

3_media/1_uploads.md

@@ -0,0 +1,15 @@
+---
+title: Uploading a file
+---
+
+You can upload a file to the AO as an attachment to a new card.
+
+1. Add a pyramid or grid to the card, if it doesn't have one.
+
+2. Drag a file from your desktop and drop it on an empty grid square.
+
+3. Wait until the file fully uploads, then it should re-download and appear on a new yellow card.
+
+If the card is blue, something went wrong.
+
+Files are stored by their hash, so if you upload the same file, it will match the existing card (after re-uploading). If an upload is breaking, change the file a tiny bit and then it will re-upload as a different card.

3_media/2_video_caching.md

@@ -0,0 +1,3 @@
+If you paste a YouTube or other website video link on a card and then click card menu—>Cache Media, the AO server will cache the video for you as an attachment on the card. This makes it possible to watch the video without visiting the original host website and potentially revealing your identity to them, and also makes it easy to download the full file. This feature relies on youtube-dl, an open-source project.
+
+There is currently no progress bar on video caching, and depending on the size of the video and the AO server's internet connection speed, it may take several minutes or a few hours to cache a video. When the video is done caching, it will display immediately.

3_media/3_playlists.md

@@ -0,0 +1 @@
+When a card with an attachment finishes playing, the next card after it will start playing.

3_media/index.md

@@ -0,0 +1,5 @@
+---
+title: Media Features
+---
+
+The AO includes some features specialized for media playback.

4_guilds/1_guilding.md

@@ -0,0 +1,5 @@
+---
+title: Creating a guild
+---
+
+Any card can be upgraded to a guild in its card menu.

4_guilds/2_joining.md

@@ -0,0 +1,5 @@
+---
+title: Joining a guild
+---
+
+A guild can have members. To join a guild, click the pin in the top-left corner of the guild card, then click the Join tab, then click Sign & Join. The first member to join a guild will start at Level 2, so that by default they can manage the Level 1 members who join afterwards.

4_guilds/3_video_chat.md

@@ -0,0 +1,5 @@
+---
+title: Joining a video room
+---
+
+A guild can have a chatroom added to it by clicking +chatroom in its card menu. The chatroom icon will appear near the top-right corner of the card. Click this button to join the chatroom, which will appear in a panel on the right side of the page. This panel will remain open as you browse other cards. The chatroom contains a secure Jitsi video chat embed—you will be asked for camera and microphone permission. Below the video room, you can also choose a color and type chat messages to create cards of that color in the chat box. These cards will be moved out of the chat box and into the guild that the chatroom belongs to if anyone grabs them.

4_guilds/4_stash.md

@@ -0,0 +1,5 @@
+---
+title: Guild stash
+---
+
+A guild can have a stash added to it by clicking +stash in its card menu. The stash icon will appear near the top-left corner of the card. The stash is a dropbox for members who have joined the guild and been accepted. There is one dropbox for each guild membership level within a guild. Members of one level can access the stash of their level and the levels below them.

4_guilds/index.md

@@ -0,0 +1,5 @@
+The title of this page should be 'Guilds' based on the folder this is index.js for.
+
+A guild is a card that has been upgraded into a group. Guilds have various features that help make groups run smoothly.
+
+All guilds on a server are listed in the Guilds sidebar.

5_events/1_booking.md

@@ -0,0 +1,19 @@
+---
+title: Booking an event
+---
+
+A card can have a time and date attached to it to turn it into an event.
+
+To schedule an event:
+
+1. Create a card or choose an existing card to turn into an event.
+
+2. Click the card's card menu, the three dots in its lower or upper right corner.
+
+3. Click "schedule event", then click the empty text box that says "set date & time".
+
+4. Use the calendar and the scrolling list of times on the right to select a date and time for the event.
+
+5. Click the "Schedule" button.
+
+The event will be scheduled and will appear in the Calendar sidebar.

5_events/2_agenda.md

@@ -0,0 +1,5 @@
+---
+title: Viewing upcoming events
+---
+
+Click the calendar icon on the left edge of the screen to show upcoming and past events.

5_events/index.md

@@ -0,0 +1,5 @@
+---
+title: Calendar & Events
+---
+
+The AO includes a calendar that allows you to plan events and schedule reminders, individually or within a guild.

6_account/1_password.md

@@ -0,0 +1,5 @@
+---
+title: Changing your password
+---
+
+Click the main menu (three dots in lower right corner) and then click Change Password. Type your new password twice and hit Enter.

6_account/2_username.md

@@ -0,0 +1,5 @@
+---
+title: Changing your username
+---
+
+Click the main menu (three dots in lower right corner) and then click your username, the top item in the menu. Enter a new username and press enter. You will need to log in with this new username next time you log in, so be careful to remember you changed it!

6_account/index.md

@@ -0,0 +1 @@
+You need a member account to log in.

7_members/1_creating.md

@@ -0,0 +1,15 @@
+---
+title: Creating new users
+---
+
+To invite someone else to this server, you must make an account for them:
+
+1. Click the Members icon on the left edge of the page to open the Members sidebar.
+
+2. Click Invite to show the account creation form.
+
+3. Type a new username for the new member (ask them what username they want).
+
+4. Click "Add Member" or press Enter to create the new member.
+
+The default password for new accounts is the same as their username.

7_members/2_rent.md

@@ -0,0 +1,13 @@
+---
+title: Monthly memberships
+---
+
+If your server offers monthly memberships, then each user may be either "active" or "inactive".
+
+Active users may use hardware resources such as RFID door control or the bitcoin soda machine. For inactive members, these features will be locked.
+
+On the 1st of each month, membership dues are charged (if set up). The amount is subtracted from your member points (visible on your member card). You can refill your points with bitcoin or lightning (see next section, "Points & Bounties", subsection entitled "Refilling points").
+
+If, on the 1st, you do not have enough points for monthly membership dues, your account will go to 0. Then, there is an eleven day grace period. On the 11th of the same month, if you still don't have the rest of the points, your account will be deactivated and you will be unable to use the door, soda machine, or other hardware resources.
+
+The amount of member dues are set by typing in a total number (e.g., rent), which is split equally amongst all active members. This amount as well as a maximum cap for individual member dues may be set in the Membership tab of Server Controls.

7_members/3_admin.md

@@ -0,0 +1,33 @@
+---
+title: Administering other members
+---
+
+The AO ships with a member moderation system that, under certain conditions, allows members to use certain administrative powers on other members. This system distributes the theoretical minimum amount of administrative power necessary to maintain social cohesion as horizontally as possible, and is known as the SENPAI SYSTEM.
+
+The administrative powers are:
+
+- reset password
+
+- ban
+
+- delete
+
+- reactivate account (= free month of membership)
+
+A "senpai" (senior) may use any of the above admin powers on a "kohai" (junior). One member (member A) is senpai to another (member B) if:
+
+- Member A is first in the member order before member B, AND
+
+- Member A's attack score is greater than Member B's defense score
+
+The order of members can be viewed in the Members panel by clicking "Order", and by default is the order in which members' accounts were created. However, the Order may also be changed. Any member may promote any member who is below them in the Order, to just ahead of them in the Order. Since whoever you promote may gain the power to delete your account, this minimizes rank changes.
+
+A member's attack score is equal to their number of vouches. A member's defense score is the higher of two numbers: 1) their attack score, or 2) the highest attack score out of any other member who vouches for them. This means that members may protect other members by vouching for them, taking them under their wing.
+
+The admin powers can be accessed in the "bark" menu via an icon that may appear on the right of each member card in the Members sidebar. The icon of a barking doge will be red and face left if the member is your kohai (junior), and will be green and face right if the member is your senpai (senior). If the member is your senpai and the icon is green, no admin menu will be available—they have one for you. If neither condition is met, but the member is below you in the order list, then a doge angel icon will appear instead for the Promote Above function, which can be used regardless of senpai status.
+
+Since both the order and vouch conditions must be met, new members cannot delete senior members even if they become popular, with many vouches. The AO is meant to be set up on multiple servers, so these features are designed to be used by a relatively unified membership (If the community splits, set up a second AO server).
+
+To reactivate another member's account, your account must be active.
+
+The first member in the Order of members has a special power: they may reactivate their own account, giving themselves a free month of membership. This item appears in the main menu.

7_members/index.md

@@ -0,0 +1 @@
+Click the Members icon on the left edge of the screen to show the Members panel. It contains all of the member cards on this server.

8_points_bounties/1_refilling.md

@@ -0,0 +1,5 @@
+---
+title: Refilling points
+---
+
+Use bitcoin to refill points (not currently implemented)

8_points_bounties/2_spending.md

@@ -0,0 +1,5 @@
+---
+title: Spending points
+---
+
+Right now the only way to spend points is to click the boat next to a priority. This assigns a point to the priority for each click, from the parent card. Then whoever checks the card first will get those points.

8_points_bounties/index.md

@@ -0,0 +1,5 @@
+---
+title: Points & Bounties
+---
+
+The AO includes a simple system of points on each server.

9_crypto/1_lightning.md

@@ -0,0 +1,5 @@
+---
+title: Lightning connection info
+---
+
+The AO integrates with the bitcoin lightning network. When the AO connects to the server's lightning node, it will display detailed information on connections to and from the server, current balances, etc.

9_crypto/2_tickers.md

@@ -0,0 +1,7 @@
+Crypto tickers can be added to the right side of the AO to monitor the relative "value" of different cryptocurrencies.
+
+To add a crypto ticker, click "Add Crypto Ticker" in the main menu. Then, enter two abbreviations for two currencies, separated by a slash, and press Enter. For example, enter "BTC / USD" to see the price of BTC in USD. For ERC-20 tokens, use the contract address of the token instead of an abbreviation
+
+Crypto tickers appear on the right edge of the page. Click a crypto ticker to modify it, or press enter when it is empty to remove it.
+
+Hover over a crypto ticker to see market info for the pair from CoinGecko.

9_crypto/index.md

@@ -0,0 +1,5 @@
+---
+title: Cryptocurrency
+---
+
+The AO includes native support for bitcoin (not currently implemented) and several other cryptocurrency-related features.

index.md

@@ -0,0 +1,11 @@
+---
+title: Introduction
+---
+
+Welcome to the AO User Manual! Here you will find a comprehensive guide to all of the AO's functions and many of its possible uses.
+
+The [ao-cli project](https://git.coalitionofinvisiblecolleges.org/autonomousorganization/ao-cli) is currently at version 0.0.5.
+
+The [ao-svelte project](https://git.coalitionofinvisiblecolleges.org/CIC/ao-svelte) is currently at version 0.0.0.0.1.
+
+This user manual is currently at version 0.7.0.

whats_it_for.md

@@ -0,0 +1,53 @@
+---
+title: What's it for?
+---
+
+There are many reasons you might set up an AO server. Here are some of the types of community projects the AO was specifically designed to support:
+
+### Local Hackerspace
+
+The AO was originally created to help a local hackerspace manage its membership dues and to allow active members to use an RFID fob to open the front door. Members can also pay bitcoin or lightning to the AO to activate the bitcoin soda machine, or use the AO to control the sidewalk LED art.
+
+### Chore Rota
+
+For a household or a local community center, the AO can be used to help organize chores and other maintenance tasks for the community. The points and bounty system in the AO make it easy to assign points amongst various projects and goals, and people who complete those tasks can claim the points on them.
+
+### Hardware Automation / IOT
+
+Rasberry Pis can be connected to the AO over a local network and controlled through customized user interfaces. Custom scripts for each device can be triggered by the AO to allow virtually any device to be connected and controlled or automated. AO users have created dancing LED sidewalk art installations, security doors, bitcoin-activated vending machines, and habit trackers, with plans for autonomous lockers and other useful devices.
+
+### Online Image Board
+
+In addition to local communities, the AO is also designed to support online-only communities. Since digital communities are ultimately grounded in the media they exchange, the AO comes with drag-and-drop file sharing and the ability to automatically sync file attachments over Tor between two paired AO servers.
+
+### Virtual Rooms
+
+The AO is also a good place to hang out online in real time. Each group can have a chatroom added to it, making it easy to create new secure virtual rooms.
+
+### Online Classes
+
+For online schools and freelance teachers, the AO makes it easy to organize a group as a class, assign roles (levels) to members of a classroom, and share cards in the dropbox that can only be accessed by members of that level.
+
+### News Syndication
+
+The AO's peer-to-peer Tor synchronization feature makes it trivial to syndicate news through multiple hops across the network. By networking our AO servers together, we can build a powerful decentralized news network.
+
+### Personal Wiki
+
+The cards on the AO make it easy to capture ideas at any time, and keep these ideas organized with the minimum number of actions. Cards can be placed inside each other, and one card can appear in multiple locations. Cards use an easy drag-and-drop interface and are searchable.
+
+### Getting Things Done
+
+The AO has been designed with a powerful productivity workflow that focuses on doing and completing tasks, not endless planning. One exciting feature, the hopper, allows you to hop automatically between your bookmarks every X to Y minutes, optionally sending you a Signal notification. This lets you get a bird's eye view of all your tasks or receive programmed reminders or affirmations throughout your day. The AO has also been designed with [David Allen's GTD](https://www.43folders.com/2004/09/08/getting-started-with-getting-things-done) system in mind.
+
+### Political Campaigns
+
+For activists or politicians, the AO has been designed as the ultimate specialized tool for decentralized community organizers and canvassers-for-the-people. The AO will help you to get a top-level view, recruit, communicate, plan timelines, build knowledge bases, and track checklists.
+
+### Email Replacement (planned feature)
+
+Send cards to other members on the same server, or sync cards securely over Tor. Future updates will allow the AO to act as a public (or members-only) website where people can go to send you messages. Also under consideration is transitional full email server integration (incoming emails will arrive as cards—a sender approved list or Captcha will stop spam before it starts).
+
+### Independent Content Publishing (planned feature)
+
+For content creators, the AO will make it easy to publish your content publicly or for members-only, and collect donations or required monthly dues from members. Why use YouTube when you can host your own content and provide your viewers a customizable and intimate free or membership experience?