feat: development book

.gitignore

@@ -1 +1,8 @@
+# MacOS dust
+.DS_Store
+
+# Rust target
 **/target
+
+# Environment Variables
+.env

book/book.toml

@@ -0,0 +1,14 @@
+[book]
+authors = ["refcell"]
+language = "en"
+multilingual = false
+src = "book/src"
+title = "OP Test Vectors"
+
+[preprocessor.mermaid]
+command = "mdbook-mermaid"
+
+[preprocessor.template]
+
+[output.html]
+additional-js = ["mermaid.min.js", "mermaid-init.js"]

book/src/SUMMARY.md

@@ -0,0 +1,7 @@
+# Summary
+
+- [Introduction](./intro.md)
+- [Test Fixture Format](./format.md)
+- [Test Runners](./runners.md)
+- [Generating a Test Fixture](./generation.md)
+- [Contributing](./contributing.md)

book/src/intro.md

@@ -0,0 +1,33 @@
+# OP Test Vectors Book
+
+_Documentation for op test vectors._
+
+## Introduction
+
+OP Test Vectors is a collection of test fixtures for testing OP Stack execution and derivation.
+Alongside test fixtures, the op-test-fixtures repository contains a CLI tool for generating new
+test fixtures written in Rust with the goal of making test fixture generation simple.
+
+It is built and maintained by members of [OP Labs][op-labs] as well as open source contributors,
+and is licensed under the MIT License.
+
+OP Test Vectors is comparible to the [ethereum-tests][ethereum-tests] repository for ethereum.
+The aim of [op-test-vectors][op-test-vectors] is then to provide a set of standard tests for all
+OP Stack client and node software to use for testing. In order to run these test fixtures against
+various execution and derivation implementations, each instance must implement their own test runner.
+For example, similar to how [revm][revm] defines a test runner, [revme][revme], to run the
+[ethereum-tests][ethereum-tests] against its ethereum execution implementation.
+
+In this book, we will break down the format of test fixtures, how to approach generating new test
+fixtures, and how to implement custom runners. Much of this book is specific to Rust, but is
+intentionally portable to other languages over the JSON interface.
+
+## Development Status
+
+**OP Test Vectors is currently in active development, and is not yet ready for use in production.**
+
+## Contributing
+
+Contributors are welcome! Please see the [contributing guide][contributing] for more information.
+
+{{#include ./links.md}}

book/src/links.md

@@ -0,0 +1,19 @@
+<!-- External -->
+
+[kona]: https://github.com/ethereum-optimism/kona
+[op-stack]: https://github.com/ethereum-optimism/optimism
+[ethereum-tests]: https://github.com/ethereum/tests
+[revm]: https://github.com/bluealloy/revm
+[revme]: https://github.com/bluealloy/revm/tree/main/bins/revme
+
+<!-- Kona links -->
+
+[op-test-vectors]: https://github.com/ethereum-optimism/op-test-vectors
+[book]: https://ethereum-optimism.github.io/op-test-vectors/
+[issues]: https://github.com/ethereum-optimism/op-test-vectors/issues
+[new-issue]: https://github.com/ethereum-optimism/op-test-vectors/issues/new
+[contributing]: https://github.com/ethereum-optimism/op-test-vectors/tree/main/CONTRIBUTING.md
+
+<!-- People -->
+
+[op-labs]: https://github.com/ethereum-optimism