Start writing a manual

Really more of a set of notes, currently.  In particular, it describes
how the element assembler works, which seems to complicated to me for
having only in-code documentation.

.gitlab-ci.yml

@@ -58,6 +58,7 @@ code-spelling-check:
   image: registry.dune-project.org/docker/ci/debian:11
   script:
   - codespell
+    --ignore-words-list numer
 
 # Verify code-formatting rules
 code-formatting-check:

doc/CMakeLists.txt

 add_subdirectory("doxygen")
+add_subdirectory("manual")

doc/manual/.gitignore

+*.aux
+*.log
+*.gz
+*.toc
+*.out
+*.upa
+*.bcf
+*.run.xml
+*.bbl
+*.blg
+*.sublime-*
+*.tdo
+*.upb
+*.fdb_latexmk
+*.fls
+*.loc
+*.soc
+
+# Final documents
+dune-gfe-manual.pdf

doc/manual/CMakeLists.txt

+dune_add_latex_document(
+  SOURCE dune-gfe-manual.tex
+  FATHER_TARGET doc
+  BUILD_ON_INSTALL
+  INSTALL ${CMAKE_INSTALL_DOCDIR}/manual)

doc/manual/dune-gfe-manual.bib

+@string{CM = "Comp. Mech."}
+@string{COMMA4 = "Comput. Methods Appl. Mech. Engrg."}
+@string{IJNME = "Int. J. Num. Meth. Eng."}
+@string{JE = "J. Elast."}
+@string{MMS = "Math. Mech. Solids"}
+@string{SIJSSC = "SIAM J. Sci. Stat. Comput."}
+@string{SINUM = "SIAM J. Numer. Anal."}
+@string{SISC = "SIAM J. Sci. Comput."}
+@string{ZAMM = "Z. Angew. Math. Mech."}
+
+
+@Article{sander:2010,
+	author = {Oliver Sander},
+	title = {Geodesic Finite Elements for {C}osserat Rods},
+	journal = IJNME,
+	year = {2010},
+	volume = {82},
+	number = {13},
+	pages = {1645--1670}
+}
+
+@article{sander:2012,
+	author =   {Oliver Sander},
+	title =    {Geodesic Finite Elements on Simplicial Grids},
+	journal =  IJNME,
+	year =     {2012},
+	volume =   {92},
+	number =   {12},
+	pages =    {999--1025}
+}
+
+@InCollection{hardering_sander:2020,
+	author = {Hanne Hardering and Oliver Sander},
+	title = {Geometric Finite Elements},
+	booktitle = {Handbook of Variational Methods for Nonlinear Geometric Data},
+	publisher = {Springer},
+	year = {2020},
+	editor = {Philipp Grohs and Martin Holler and Andreas Weinmann}
+}
+
+@article{sander:2015,
+	author =   {Oliver Sander},
+	title =    {Geodesic Finite Elements of Higher Order},
+	year = {2015},
+	journal = "IMA J. Numer. Anal.",
+	doi = "10.1093/imanum/drv016"
+}
+
+@Book{sander:2020,
+ title = {{DUNE}---The Distributed and Unified Numerics Environment},
+ publisher = {Springer},
+ year = {2020},
+ author = {Oliver Sander}
+}
+
+@InProceedings{absil_mahony_trumpf:2013,
+ author = {Pierre-Antoine Absil and Robert Mahony and Jochen Trumpf},
+ title = {An Extrinsic Look at the {Riemannian} {Hessian}},
+ booktitle = {Geometric Science of Information},
+ pages = {361--368},
+ year = {2013},
+ editor = {Nielsen, F. and Barbaresco, F.},
+ publisher = {Springer},
+ doi = {10.1007/978-3-642-40020-9_39},
+}
+
+@Article{grohs_hardering_sander_sprecher:2019,
+	author = {P. Grohs and H. Hardering and O. Sander and M. Sprecher},
+	title = {Projection-Based Finite Elements for Nonlinear Function Spaces},
+	journal = SINUM,
+	year = {2019},
+	volume = {57},
+	number = {1},
+	pages = {404--428}
+}
+
+@Article{nebel_sander_birsan_neff:2023,
+ author = {Lisa Julia Nebel and Oliver Sander and Mircea Bîrsan and Patrizio Neff},
+ title = {A geometrically nonlinear {Cosserat} shell model for orientable and non-orientable surfaces: {Discretization} with geometric finite elements},
+ journal = COMMA4,
+ year = {2023},
+ volume = {416},
+ pages = {116309},
+ doi = {10.1016/j.cma.2023.116309},
+}