[TODO] Renamed from KNOWN_ISSUES.

Author: Murilo Marinho

KNOWN_ISSUES.md

@@ -23,9 +23,9 @@ This work is licensed under a
 
 ### Basic 
 
-See [The Basics of Kinematic Modeling and Control of Serial-link Manipulators Using `numpy`](basic_lessons/README.md) for robotic manipulators basics using `numpy`              
+See [The Basics of Kinematic Modeling and Control of Serial-link Manipulators Using `numpy`](basic_lessons/README.md).            
 
 
 ### Advanced 
 
-See [Dual Quaternion Lessons Index](dqrobotics/README.md) for Kinematic modeling and control of serial-link robotic manipulators using `dqrobotics`: From zero to hero.
+See [Kinematic modeling and control of serial-link robotic manipulators using `dqrobotics`: From zero to hero.](dqrobotics/README.md).

README.md

@@ -0,0 +1,14 @@
+# TODO
+
+## Known issues in `dqrobotics` lessons
+
+1. Originally, the lessons written in `MATLAB` did not allow the use of latex macros. This means that the conversion from those to Jupyter notebooks brought notation as-is, which is not entirely compliant with the [latest notation](https://github.com/IncompleteGuides/lyx-macros). This is a very time consuming task so it will only be attempted with community support or further funding sources.
+1. The current `plot` method using `dqrobotics-pyplot` in the Jupyter notebook is generating a phantom image besides the animation videos. There are instructions online that allow us to tackle this issue, but I haven't been able to find one
+that properly shows the video but not the image.
+
+## Text-based notebooks
+
+- Converting from traditional Jupyter notebooks to text-based notebooks might be an interesting topic to explore. See
+  [link](https://myst-nb.readthedocs.io/en/latest/authoring/text-notebooks.html#authoring-text-notebooks). Classic notebooks
+  store cell output on itself, with implications on version control software. While classic Jupyter notebooks are more
+  easily usable without extensions, `jupytext` seemingly allows for the conversions. See [link](https://jupyterbook.org/en/stable/file-types/myst-notebooks.html).

TODO.md

@@ -26,9 +26,14 @@ project:
   license:
     content:
       id: CC-BY-NC-SA-4.0
+  #exports:
+  #  - format: pdf
+  #    date: 10 May 2023
+      # https://github.com/myst-templates
+  #    template: plain_latex_book
+      #article: basic_lessons/README.md
+  #    output: exports/basic_lessons.pdf
 
-#  exports:
-#  - format: pdf
   toc:
     - file: README.md
     - title: "[Basic] Robotics using numpy"
@@ -51,7 +56,7 @@ project:
         - file: dqrobotics/lesson7/lesson_dq7_robot_control_basics_part3.ipynb
         - file: dqrobotics/lesson8/lesson_dq8_optimization_based_robot_control.ipynb
     - file: CHANGELOG.md
-    - file: KNOWN_ISSUES.md
+    - file: TODO.md
 
 site:
   template: book-theme