From 5863f5ce1159c8e2083c461dc7f00e61dfe67783 Mon Sep 17 00:00:00 2001
From: Raphael Forment <raphael.forment@gmail.com>
Date: Sat, 19 Aug 2023 11:27:44 +0200
Subject: [PATCH] more docs

---
 index.html           |  2 +-
 src/Documentation.ts | 36 +++++++++++++++++++++++++++++++-----
 src/main.ts          |  2 +-
 3 files changed, 33 insertions(+), 7 deletions(-)

diff --git a/index.html b/index.html
index 0de1f78..2094643 100644
--- a/index.html
+++ b/index.html
@@ -89,7 +89,7 @@
               </div>
             </div>
             <div class="space-y-2">
-              <h2 class="font-semibold dark:text-gray-400">Learning More</h2>
+              <h2 class="font-semibold dark:text-gray-400">More</h2>
               <div class="flex flex-col">
                 <a rel="noopener noreferrer" id="docs_about" class="pl-2 pr-2 text-xl hover:bg-neutral-800 py-1 my-1 rounded-lg">About Topos</a>
               </div>
diff --git a/src/Documentation.ts b/src/Documentation.ts
index 665006a..22ab8d9 100644
--- a/src/Documentation.ts
+++ b/src/Documentation.ts
@@ -37,7 +37,11 @@ if (bar() % 4 > 2 ) {
 const software_interface: string = `
 # Interface
 
-Topos works by linking together several scripts:
+The Topos interface is molded around the core concepts at play: _scripts_ and _universes_.
+
+## Scripts
+
+Topos works by linking together several scripts into what is called a _universe_:
 
 - the global script (${key_shortcut('Ctrl + G')}): Evaluated for every clock pulse.
 - the local scripts (${key_shortcut('Ctrl + L')}): Evaluated _on demand_. Local scripts are storing musical parts, logic or whatever you need!
@@ -59,19 +63,23 @@ const time: string = `
 Time in Topos is handled by a _transport_ system. It allows you to **play**, **pause** and **reset** time. Time is quite simple to understand:
 
 - **bars**: how many bars have elapsed since the origin of time.
-- **beats**: how many beats have elapsed since the origin of time.
+- **beats**: how many beats have elapsed since the beginning of the bar.
 - **pulse**: how many pulses have elapsed since the last beat.
 
-The **pulse** is also known as the [PPQN](https://en.wikipedia.org/wiki/Pulses_per_quarter_note). By default, Topos is using a PPQN of 48. It means that the lowest possible rhythmic value is 1/48 of a quarter note. That's plenty of time already.
+The **pulse** is also known as the [PPQN](https://en.wikipedia.org/wiki/Pulses_per_quarter_note). By default, Topos is using a pulses per quarter note of 48. It means that the lowest possible rhythmic value is 1/48 of a quarter note. That's plenty of time already. Music is sequenced by playing around with these core time values.
 
 ## Programming with time
 
 Every script can access the current time by using the following functions:
 
-- \`bar()\` returns the current bar since the origin of time.
-- \`beat()\` returns the current beat since the origin of the bar.
+- \`bar(n: number)\` returns the current bar since the origin of time.
+
+- \`beat(n: number)\` returns the current beat since the origin of the bar.
+
 - \`ebeat()\` returns the current beat since the origin of time.
+
 - \`pulse()\` returns the current bar since the origin of the beat.
+
 - \`epulse()\` returns the current bar since the origin of time.
 
 `
@@ -81,6 +89,24 @@ const sound: string = `
 
 const about: string = `
 # About Topos
+
+## The Topos Project
+
+Topos is an experimental web based algorithmic sequencer programmed by **BuboBubo** (Raphaël Forment) and **Amiika** (Miika Alonen). It is written using [TypeScript](https://google.fr) and [Vite](https://google.fr). Many thanks to Felix Roos for making the [Superdough](https://www.npmjs.com/package/superdough) audio backend available for experimentation. 
+
+This project is based on the [Monome Teletype](https://monome.org) by Brian Crabtree. We hope to follow and honor the same spirit of sharing and experimentation. How much can the Teletype be extended while staying accessible and installation-free?
+
+## About Live Coding
+
+**Amiika** and I are both very involved in the [TOPLAP](https://toplap.org) and [Algorave](https://algorave.com) scenes. We previously worked on the [Sardine](https://sardine.raphaelforment.fr) live coding environment for Python. **Amiika** has been working hard on its own algorithmic pattern language called [Ziffers](https://github.com/amiika/ziffers). A version of it is available in Topos! **Raphaël** is doing live coding with other folks from the [Cookie Collective](https://cookie.paris) and from the city of Lyon (France).
+
+## Free and open-source software
+
+Topos is a free and open-source software distributed under [GPL-3.0](https://github.com/Bubobubobubobubo/Topos/blob/main/LICENSE) licence.
+We welcome all contributions and ideas. You can find the source code on [GitHub](https://github.com/Bubobubobubobubo/topos).
+You can also join us on [Discord](https://discord.gg/8Q2QV6Z6) to discuss about the project and live coding in general.
+ 
+**Have fun!**
 `
 
 const functions: string = `
diff --git a/src/main.ts b/src/main.ts
index 2b72f9d..7f26f9b 100644
--- a/src/main.ts
+++ b/src/main.ts
@@ -29,7 +29,7 @@ showdown.setFlavor('github')
 import showdownHighlight from 'showdown-highlight';
 const classMap = {
   h1: 'text-4xl text-white ml-4 mx-4 my-4 mb-8',
-  h2: 'text-3xl text-white mx-4 my-4 mt-8',
+  h2: 'text-3xl text-white mx-4 my-4 mt-12 mb-6',
   ul: 'text-underline',
   li: 'ml-12 list-disc text-2xl text-white mx-4 my-4 leading-normal',
   p:  'text-2xl text-white mx-4 my-4 leading-normal',