Creates a table for documentation generation tools and add more examples

Author: dpshelio

ch04packaging/04documentation.ipynb

@@ -61,15 +61,21 @@
     "together with the signature, into a web page.\n",
     "\n",
     "The most popular is [Doxygen](http://www.doxygen.nl/).\n",
-    "[Have a look at an example of some Doxygen output](\n",
-    "http://www.bempp.org/cppref/2.0/group__abstract__boundary__operators.html).\n",
     "\n",
-    "[Sphinx](http://sphinx-doc.org/) is nice for Python, and works with C++ as well.\n",
-    "Here's some [Sphinx-generated output](http://www.bempp.org/pythonref/2.0/bempp_visualization.html)\n",
-    "and the [corresponding source code](https://bitbucket.org/bemppsolutions/bempp/src/8f10af0b0b4a94bc36c6236eb9ddb2a34cde1756/python/bempp/visualization.py?at=v2.0.2&fileviewer=file-view-default).\n",
-    "[Breathe](https://breathe.readthedocs.io/en/latest/) can be used to make Sphinx and Doxygen work together.\n",
+    "Here are some other documentation tools used in different languages, have a look at the generated and source examples:\n",
     "\n",
-    "[Roxygen](https://cran.r-project.org/web/packages/roxygen2/vignettes/roxygen2.html) is good for R.\n"
+    "\n",
+    "| Language | Name                                                                                | Output example                                                                      | source                                                                                                                                           |\n",
+    "| ---      | ---                                                                                 | ---                                                                                 | ---                                                                                                                                              |\n",
+    "| Multiple | [Doxygen](http://www.doxygen.nl/)                                                   | [`Array` docs](https://eigen.tuxfamily.org/dox/classEigen_1_1Array.html)            | [`Array` docstring source](https://gitlab.com/libeigen/eigen/-/blob/55e3ae02ac1f13fbcc7a83f5e37a39fd2b142db1/Eigen/src/Core/Array.h#L26-L45)     |\n",
+    "| Python   | [Sphinx](http://sphinx-doc.org/)                                                    | [`numpy.ones` docs](https://numpy.org/doc/1.21/reference/generated/numpy.ones.html) | [`numpy.ones` docstring source](https://github.com/numpy/numpy/blob/v1.21.0/numpy/core/numeric.py#L149-L206)                                     |\n",
+    "| R        | [Roxygen](https://cran.r-project.org/web/packages/roxygen2/vignettes/roxygen2.html) |                                                                                     |                                                                                                                                                  |\n",
+    "| Julia    | [Documnenter.jl](https://juliadocs.github.io/Documenter.jl/stable/)                 | [`ones` docs](https://docs.julialang.org/en/v1/base/arrays/#Base.ones)              | [`ones` docstring source](https://github.com/JuliaLang/julia/blob/ae8452a9e0b973991c30f27beb2201db1b0ea0d3/base/array.jl#L475-L493)              |\n",
+    "| Fortan   | [FORD](https://github.com/Fortran-FOSS-Programmers/ford)                            | [`arange` docs](https://stdlib.fortran-lang.org/interface/arange.html)              | [`arange` docstring source](https://github.com/fortran-lang/stdlib/blob/d14fca8e7cc36ed5f6f84d2bf576c91c2e54eb07/src/stdlib_math.fypp#L276-L290) |\n",
+    "| Rust     | [rustdoc](https://doc.rust-lang.org/rustdoc/what-is-rustdoc.html)                   | [`Matrix` docs](https://docs.rs/nalgebra/0.18.0/nalgebra/base/struct.Matrix.html)   | [`Matrix` docstring source](https://github.com/dimforge/nalgebra/blob/8ea8ac70d5ad4bae865e6246a48455bf0b3fa3d2/src/base/matrix.rs#L59-L157)      |\n",
+    "\n",
+    "[Breathe](https://breathe.readthedocs.io/en/latest/) can be used to make Sphinx and Doxygen work together (good to keep documentation, for example, of a c++ project that includes python bindings).\n",
+    "\n"
    ]
   },
   {
@@ -95,8 +101,8 @@
     "There are various conventions for how to write docstrings, but the native Sphinx one doesn't look nice when used with\n",
     "the built in `help` system.\n",
     "\n",
-    "In writing Greeter, we used the docstring conventions from NumPy.\n",
-    "So we use the [numpydoc](https://numpydoc.readthedocs.io/en/latest/) sphinx extension to \n",
+    "In writing Greeter, we used the [docstring conventions from NumPy](https://numpy.org/doc/stable/docs/howto_document.html).\n",
+    "So we use the [`numpydoc`](https://numpydoc.readthedocs.io/en/latest/) sphinx extension to\n",
     "support these (Note: you will need to install this extension for the later examples to work)."
    ]
   },