Generate Docs

Generate LaTeX algorithm PDFs and Doxygen HTML documentation for FLEKS.

3|2|Updated Jul 5, 2023
One-click install
npx skills add https://github.com/SWMFsoftware/FLEKS --skill generate-docs-swmfsoftware
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Generate Docs
Source: https://github.com/SWMFsoftware/FLEKS/tree/main/.agent/skills/generate-docs
Command: npx skills add https://github.com/SWMFsoftware/FLEKS --skill generate-docs-swmfsoftware

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the process of generating and maintaining comprehensive documentation for the FLEKS project, ensuring all aspects from algorithms to code are well-documented.

Core Features & Use Cases

  • LaTeX PDF Generation: Compiles Algorithm.tex into a professional PDF document detailing the simulation's mathematical foundations.
  • Doxygen Integration: Guides users on setting up and running Doxygen to generate HTML documentation from code comments.
  • PARAM.XML and AGENT.md Management: Provides instructions on documenting input parameters and architectural overviews.
  • Use Case: A new developer joins the project and needs to understand the core algorithms. This Skill provides the exact commands to generate the algorithm PDF and explains where to find other crucial documentation like AGENT.md files.

Quick Start

Use the Generate Docs skill to build the algorithm PDF documentation.

Frequently Asked Questions about Generate Docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate LaTeX PDF documentation for simulation algorithms?

To generate LaTeX PDF documentation, compile the `Algorithm.tex` file into a professional PDF detailing the simulation's mathematical foundations. This streamlines maintaining comprehensive algorithm documentation for the project.

How do I set up Doxygen to generate HTML code documentation?

Doxygen generates HTML documentation from code comments to ensure all code aspects are well-documented. This skill guides users on setting up and running Doxygen to extract and compile code structure details.

What is the best way to manage PARAM.XML and AGENT.md files for project parameters?

Managing `PARAM.XML` and `AGENT.md` files involves documenting input parameters and architectural overviews for clear project understanding. This provides instructions to maintain these files and adhere to documentation standards.

Does the Generate Docs skill work for maintaining documentation for new developers?

Yes, the Generate Docs skill works for maintaining documentation for new developers by providing exact commands to generate the algorithm PDF and explaining where to find crucial documentation like `AGENT.md` files for architectural overviews.

Can I use this skill to enforce documentation standards for code and algorithms?

Yes, you can use this skill to enforce documentation standards for code, algorithms, and parameters. It facilitates adherence to project documentation standards by integrating LaTeX and Doxygen workflows for comprehensive coverage.