TopoToolbox / libtopotoolbox

A C library for the analysis of digital elevation models.
https://topotoolbox.github.io/libtopotoolbox/
GNU General Public License v3.0
0 stars 3 forks source link

Create framework for documenting libtopotoolbox #26

Open wkearn opened 2 months ago

wkearn commented 2 months ago

Now that we have some functional code in libtopotoolbox, we should start documenting it more thoroughly. The goals for the documentation should be

  1. Document the libtopotoolbox API so that users can use libtopotoolbox in their projects
  2. Detail the mechanics of incorporating libtopotoolbox into another project
  3. Describe the build process, CI system, style guidelines and other information that contributors need to know to contribute effectively to libtopotoolbox
  4. Provide enough information about the structure of the code that contributors and future maintainers understand what it is for, how it does what it does, and the design decisions that went into it

This issue coordinates the creation of these documents and others that might come up during this initial phase of development, and I intend to close it once we have these documents and the appropriate infrastructure for supporting them. Documentation should continue to be added and improved as development of the library continues.