Flatten TOC hierarchy and update landing page

Author: glopesdev

articles/intro.md

@@ -1,28 +1,24 @@
-- name: About
-  items:
-    - name: What is Harp
-      href: about.md
+- name: Get started
+- name: Basic Concepts
+  href: about.md
+- name: Quick Start
+  href: ../index.md
 - name: Protocol
-  items:
-    - name: Binary Protocol
-      href: ~/protocol/BinaryProtocol-8bit.md
-    - name: Common Registers
-      href: ~/protocol/Device.md
-    - name: Synchronization Clock
-      href: ~/protocol/SynchronizationClock.md
+- name: Binary Protocol
+  href: ../protocol/BinaryProtocol-8bit.md
+- name: Common Registers
+  href: ../protocol/Device.md
+- name: Synchronization Clock
+  href: ../protocol/SynchronizationClock.md
 - name: Control Interface
-  items:
-    - name: Quickstart
-      href: intro.md
-    - name: Operators
-      href: operators.md
-    - name: Firmware
-      href: firmware.md
-    - name: Logging
-      href: logging.md
-    - name: Message Manipulation
-      href: message-manipulation.md
+- name: Operators
+  href: operators.md
+- name: Firmware
+  href: firmware.md
+- name: Logging
+  href: logging.md
+- name: Message Manipulation
+  href: message-manipulation.md
 - name: Data Interface
-  items:
-    - name: Python
-      href: python.md
+- name: Python
+  href: python.md

articles/toc.yml

@@ -1,12 +1,29 @@
-# **Harp** Documentation
+Quick Start
+===========
 
-[!include[what-is-harp](./articles/what-is-harp.md)]
+Harp is a standardized solution for:
+  - Automatic [sub-millisecond synchronization](./protocol/SynchronizationClock.md) across devices
+  - A [binary protocol](./protocol/BinaryProtocol-8bit.md) for communication between devices and PC
+  - [Hardware templates](./protocol/Device.md) for developing new devices
 
-## Quick Start
+All [Harp Devices](./protocol/whoami.md) implement the [Harp Protocol](./protocol/BinaryProtocol-8bit.md) to communicate with an host PC. The `Bonsai.Harp` library provides an implementation of the Harp protocol that can be used to interface with any Harp device.
 
-* [What is Harp](./articles/about.md)
-* [Binary Protocol](./protocol/BinaryProtocol-8bit.md)
-* [Bonsai Interface](./articles/intro.md)
+## How to install
 
-> [!Warning]
-> These docs are under active development, feel free to contribute by either [raising an issue](https://github.com/orgs/harp-tech/discussions) or following the links saying **Improve this Doc**.
+1. [Install Bonsai](https://bonsai-rx.org)
+2. [Install FTDI D2XX Drivers](https://ftdichip.com/wp-content/uploads/2021/08/CDM212364_Setup.zip)
+3. Install `Bonsai.Harp.Design` using the [Bonsai package manager](https://bonsai-rx.org/docs/articles/packages.html).
+
+## Device specific packages
+
+A high-level interface will usually be available for the specific Harp device you are using. To install them, first change the package manager **Package source** to `nuget.org`. Then, in the search bar, look for your device by typing: `harp.<device>`. For instance, for the [Harp Behavior](xref:Harp.Behavior) board, you should find the following package:
+
+<img alt="Installing a Harp device package" src="~/images/behavior-package.png" style="max-height:450px;object-fit:contain" />
+
+The device nodes should now be available in the Bonsai Toolbox and you can start using them in your workflows. See [Operators](./articles/operators.md) for examples of how to manipulate and control Harp devices.
+
+## Next Steps
+
+- [Logging](./articles/logging.md)
+- [Firmware](./articles/firmware.md)
+- [Data Interface](./articles/python.md)