Skip to content
GitLab
Projects Groups Snippets
  • /
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in
  • A aml
  • Project information
    • Project information
    • Activity
    • Labels
    • Members
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
  • Issues 33
    • Issues 33
    • List
    • Boards
    • Service Desk
    • Milestones
  • Merge requests 7
    • Merge requests 7
  • CI/CD
    • CI/CD
    • Pipelines
    • Jobs
    • Schedules
  • Deployments
    • Deployments
    • Environments
    • Releases
  • Monitor
    • Monitor
    • Incidents
  • Analytics
    • Analytics
    • Value stream
    • CI/CD
    • Repository
  • Wiki
    • Wiki
  • Snippets
    • Snippets
  • Activity
  • Graph
  • Create a new issue
  • Jobs
  • Commits
  • Issue Boards
Collapse sidebar
  • argo
  • aml
  • Issues
  • #67
Closed
Open
Issue created May 06, 2020 by Swann Perarnau@perarnauOwner0 of 8 checklist items completed0/8 checklist items

AML Doc cleanup

Need to merge the tutorial pages with the rest of the documentation. The plan is to basically take the text of the tutorial, and make it the entire doc, adding and fixing stuff in places.

The overall structure of the documentation would then be:

  • Building Block
    • Overview/Definition
    • Generic Operations
    • Implementations description
    • Examples from the tutorial

One section like this for each building block, plus a couple of pages for installation, hello world, and a good overview of the generic/implementation system for building blocks.

Most of the code/text is already there, we just need to clean it up, and merge the entire thing in master.

TODO:

  • Spack install in overview
  • Restructure a bit the area section to match the others
  • remove? scratchpad until further notice
  • Fixup FORTRAN/C doc in places
  • merge structure of pages one by one
  • aml_version doc missing from overview
  • fix @param for [in,out] across the doc (its param[in], not param name[in])
  • fix _DECL macros still mentioned in README

Also, we should be careful not to use the doxygen groups directly if we can, and reference individual functions/variables, it would look better.

Edited Aug 18, 2020 by Swann Perarnau
Assignee
Assign to
Time tracking