Basic functionalities

Author: Murilo Marinho

CHANGELOG.md

@@ -2,10 +2,10 @@
 
 ## 2025
 
-- I'm removing `spatialmath` from the tutorials and moving any old content to `legacy/spatialmath`. The original intention when adding this library was to facilitate more complex content in later parts of the module. With variable levels of programming knowledge in the standard cohort this is not possible, and the following issues were observed:
-   - `spatialmath` not being available as binary package in many distributions, causing students to have to compile the `wheel` even when using `pip`. 
-        - In Windows enviroments, for example, this means having a working VS Compiler installation which is not default and is beyond the scope of this module. 
-        - In any distribution, this could take several minutes and even fail depending on student's enviroments.
-   - Students tend to default to memorising the library functions instead of understanding the underlying mechanism, irrespective of how trivial the operations are. It is more pedagogical to rely on the matricial operations that they are expected to learn and reinforce that knowledge.
+- I've moved this to `mystmd` from the previous version kindly made by [juanjqo](https://github.com/juanjqo). I will try to keep the images alive
+as much as possible.
 
-- Remove all mentions of `import` in sample code, and keep them to explicit and isolated import cells. Despite the clear indication in the text that the `import` statement was merely illustrative, novice readers often default to copying and pasting chunks of example code causing extraneous `import` statements that result in unprofessional code that, beyond aesthetics, can cause all sorts of issues.
+## History
+
+Previous versions of this library and website were made while I was a student or employed at the University of Tokyo. Very early
+versions of this were made while I was a student at the University of Brasilia.

README.md

@@ -1 +1,48 @@
-# SmartArmStack.github.io
+# SAS
+
+## Quickstart
+
+```commandline
+TODO
+```
+
+## A quick note
+
+If being read on GitHub, please note that this page is better seen at https://smartarmstack.github.io.
+
+## Overview
+
+```{image} img/computer_ros2.svg
+:width: 300px
+:align: left
+```
+
+The SmartArmStack has been developed in support of the SmartArm robot described in http://doi.org/10.1002/rcs.2053. 
+It has then been used in dozens of publications and updated in http://doi.org/10.1109/MRA.2023.3336472. Please cite one
+of these references if you use `SAS` in your own work.
+
+The current version of `SAS` supports `ROS 2`. 
+
+## About
+
+`SAS` is a C++ framework with Python bindings to enable fast prototyping on ROS 2. Focus on your application. 
+The concept of `SAS` is to split away `ROS 2` code into `client` and `server` classes, allowing your code to use
+`ROS 2` interfaces without any need to create `publishers` or `subscribers` manually.
+
+## License
+
+Most of the library is licensed in LGPLv3. Some packages are licensed as Research Only, with no commercial use allowed.
+
+## Installation instructions and Tutorials
+
+Please refer to https://ros2-tutorial.readthedocs.io/en/latest/sas/index.html.
+
+## Dependencies
+
+```{image} img/computer_capi_open_tech.svg
+:width: 300px
+:align: left
+```
+
+The main dependencies to note are [ros2](https://www.ros.org), [dqrobotics](https://dqrobotics.github.io), [eigen3](https://eigen.tuxfamily.org/index.php?title=Main_Page), and [pybind11](https://pybind11.readthedocs.io/en/stable/).
+

book.md

@@ -4,22 +4,8 @@
 python -m pip install jupyter-book --pre
 
 # Otherwise the links will not be correctly set up for th webpage
-export BASE_URL="https://marinholab.github.io/OpenExecutableBooksRobotics"
+export BASE_URL="https://smartarmstack.github.io"
 
-# This is a bit hacky.
-# https://github.com/orgs/jupyter-book/discussions/2055#discussioncomment-13250715
-# This is my temporary hacky solution
-
-# Run once without the devel
-cp myst.yml _myst.yml
-sed -i.bak '/\#USING DQROBOTICS DEVEL \[START\]/,/\#USING DQROBOTICS DEVEL \[END\]/d' myst.yml
-echo "RUN ONE, WITHOUT DQROBOTICS DEVEL PAGES"
-cat myst.yml
-python -m jupyter book build --html --execute
-
-# Run again with the devel. The cached should no longer collide
-mv _myst.yml myst.yml
-python -m jupyter book build --html --execute
-echo "RUN TWO, WITH DQROBOTICS DEVEL PAGES"
-cat myst.yml
+# Build page
+python -m jupyter book build --html