From 1d2c9c52a74732f5f625bc0f8b0eecc5f938fdd6 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?David=20G=C3=B3mez=20G?= Date: Thu, 1 Aug 2024 18:42:50 +0200 Subject: [PATCH] Added docs/README.md --- docs/README.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) create mode 100644 docs/README.md diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 0000000..4435ed2 --- /dev/null +++ b/docs/README.md @@ -0,0 +1,23 @@ +# Documentation For Axon Framework - Reactor Extension. + +This folder contains the docs related to the Reactor Extension for Axon Framework. The docs in this folder are written as part of the [AxonIQ Library](https://library.axoniq.io), and are [written in Ascii and built with Antora.](https://library.axoniq.io/contribution_guide/overview/platform.html) + +The following are the current documentation sources (folders): + +- `extension-guide` : [The Reactor Extension Guide](https://library.axoniq.io/reactor_extension_guide/index.html) + +## Contributing to the docs. + +You are welcome to contribute to these docs. Whether you want to fix a typo, or you find something missing, something that is not clear or can be improved, or even if you want to write an entire piece of docs to illustrate something that could help others to understand the use of the Bike Rental App, you are more than welcome to send a Pull Request to this GitHub repository. Just make sure you follow the guidelines explained in [AxonIQ Library Contribution Guide](https://library.axoniq.io/contribution_guide/index.html) + +## Building and testing these docs locally. + +If you want to build and explore the docs locally (because you have made changes or before contributing), you can use the Antora's build file in `docs/_playbook` folder. + +You can check the [detailed information on how the process to build the docs works](https://library.axoniq.io/contribution_guide/overview/build.html), but in short, all you have to do is: + +1. Make sure you have Node (a LTS version is preferred), Antora and Vale installed in your system. +2. CD to the `docs/_playbook` folder. +3. Run `npx antora playbook.yaml`. Antora will generate the set of static html files under `docs/_playbook/build/site` +4. Move to `docs/_playbook/build/site` and execute some local http server to serve files in that directory. For example by executing `python3 -m http.server 8070` +5. Open your browser and go to `http://localhost:8070`. You should be able to navigate the local version of the docs.