Align README with asdf-ada structure

Author: Jonathan D.A. Jewell

README.adoc

@@ -0,0 +1,162 @@
+= asdf-rescript
+:toc: macro
+:toclevels: 3
+:icons: font
+:source-highlighter: rouge
+:experimental:
+:author: hyperpolymath
+:revnumber: 0.1.0
+:url-asdf: https://asdf-vm.com
+:url-tool: https://img.shields.io/badge/license-PMPL--1.0-blue.svg[License,link=
+:url-repo: https://github.com/hyperpolymath/asdf-rescript-plugin
+
+image:https://img.shields.io/badge/license-PMPL--1.0-blue.svg[License,link="https://github.com/hyperpolymath/palimpsest-license"]
+image:https://img.shields.io/badge/Philosophy-Palimpsest-1f6feb.svg[Palimpsest,link="https://github.com/hyperpolymath/palimpsest-license"]
+image:https://img.shields.io/github/license/hyperpolymath/asdf-rescript-plugin?style=flat-square[License,link=LICENSE]
+image:https://img.shields.io/github/v/release/hyperpolymath/asdf-rescript-plugin?style=flat-square[Release,link={url-repo}/releases]
+image:https://img.shields.io/github/actions/workflow/status/hyperpolymath/asdf-rescript-plugin/ci.yml?branch=main&style=flat-square[Build Status,link={url-repo}/actions]
+image:https://img.shields.io/badge/asdf-plugin-blue?style=flat-square[asdf Plugin,link={url-asdf}]
+
+[.lead]
+An {url-asdf}[asdf] plugin to install and manage {url-tool}[Rescript] versions.
+
+toc::[]
+
+== Overview
+
+=== What is Rescript?
+
+Rescript is an upstream tool managed by this plugin. Refer to the official
+project documentation for details on usage and capabilities.
+
+=== What is asdf?
+
+{url-asdf}[asdf] is a universal version manager that allows you to manage
+multiple runtime versions with a single CLI tool.
+
+=== Why asdf-rescript?
+
+[cols="1,3"]
+|===
+|Feature |Benefit
+
+|**Version Switching**
+|Switch between Rescript versions per project
+
+|**Project Isolation**
+|Pin Rescript per repository via `.tool-versions`
+
+|**Reproducible Builds**
+|Align CI/CD and developer environments to the same Rescript version
+
+|**Cross-Platform**
+|Works on Linux and macOS, with Windows via WSL
+|===
+
+== Prerequisites
+
+=== System Requirements
+
+[cols="1,2,3"]
+|===
+|Platform |Minimum Version |Notes
+
+|**Linux**
+|Ubuntu 20.04+ / Fedora 35+ / Debian 11+
+|x86_64 and aarch64 supported
+
+|**macOS**
+|macOS 11+
+|Intel and Apple Silicon
+
+|**Windows**
+|Windows 10+ with WSL2
+|Native support planned
+|===
+
+=== Dependencies
+
+[source,bash]
+----
+# Debian/Ubuntu
+sudo apt-get update
+sudo apt-get install -y curl git
+
+# Fedora/RHEL
+sudo dnf install -y curl git
+
+# macOS (via Homebrew)
+brew install curl git
+----
+
+=== asdf Installation
+
+[source,bash]
+----
+# Clone asdf
+git clone https://github.com/asdf-vm/asdf.git ~/.asdf --branch v0.14.0
+
+# Add to your shell (bash)
+echo '. "$HOME/.asdf/asdf.sh"' >> ~/.bashrc
+echo '. "$HOME/.asdf/completions/asdf.bash"' >> ~/.bashrc
+
+# Reload your shell
+exec $SHELL
+----
+
+== Installation
+
+=== Adding the Plugin
+
+[source,bash]
+----
+asdf plugin add rescript https://github.com/hyperpolymath/asdf-rescript-plugin.git
+asdf plugin list
+----
+
+=== Installing Rescript Versions
+
+[source,bash]
+----
+asdf list all rescript
+asdf install rescript latest
+asdf install rescript 0.1.0
+----
+
+=== Setting the Version
+
+[source,bash]
+----
+asdf global rescript 0.1.0
+asdf local rescript 0.1.0
+asdf current rescript
+rescript --version
+----
+
+== Usage
+
+=== Project Configuration
+
+[source]
+----
+rescript 0.1.0
+----
+
+== Configuration
+
+This plugin uses standard asdf behavior. No additional configuration is
+required.
+
+== Troubleshooting
+
+* Ensure `rescript` is on PATH after installation.
+* Verify the installed version with `rescript --version`.
+* Reinstall if a cached release is corrupted.
+
+== Contributing
+
+See link:CONTRIBUTING.adoc[CONTRIBUTING] for guidelines.
+
+== License
+
+Palimpsest-MPL License v1.0 (PMPL-1.0)—see link:LICENSE[LICENSE].