Genta-Technology / Kolosal

Apache License 2.0
1 stars 1 forks source link

Create Comprehensive Documentation for Kolosal AI Project #25

Open rifkybujana opened 3 weeks ago

rifkybujana commented 3 weeks ago

Create Comprehensive Documentation for Kolosal AI Project

Description: We need to create thorough documentation for the Kolosal AI project to make it easy for developers to understand, contribute, and utilize the codebase effectively. The documentation should cover the following areas: code structure, widget components & classes, getting started, contribution guidelines, compilation instructions, and code-writing guidelines.

Tasks:

  1. Document Code Structure:

    • Provide an overview of the code structure, detailing the purpose of each major directory and file.
    • Include information on core modules and their relationships within the project.
    • Add visual aids, like a diagram or flowchart, if applicable, to illustrate how components interact.
  2. Widget Components & Classes:

    • List all major widget components and classes, describing their functionality and how they integrate within the application.
    • Include usage examples for each widget and class, with sample code snippets to demonstrate how they can be utilized or customized.
    • Describe dependencies between classes, if any, and provide guidance on extending or modifying widgets.
  3. Getting Started Guide:

    • Provide clear instructions on how to set up the development environment.
    • Outline the required dependencies, with installation commands and configuration settings.
    • Include steps for cloning the repository and running the project locally.
    • Add troubleshooting tips for common setup issues.
  4. Contribution Guide:

    • Define contribution rules and standards, including setting up branches and submitting pull requests.
    • Describe the process for filing issues, suggesting new features, and discussing potential improvements.
    • Add a code of conduct for contributors, emphasizing respectful and constructive collaboration.
  5. Compilation Instructions:

    • Provide detailed steps for compiling the project, including platform-specific instructions (Linux, macOS, Windows).
    • List any required libraries or build tools, along with setup and configuration instructions.
    • Include CMake commands and flags, if applicable, to facilitate building the project with different configurations.
  6. Code-Writing Guidelines:

    • Outline code-writing conventions, such as naming conventions, file organization, and commenting practices.
    • Describe the preferred style for function declarations, variable names, and inline documentation.
    • Include examples of well-documented functions and modules as a reference for contributors.
  7. Review and Publish Documentation:

    • Compile all documentation into a structured README or a dedicated docs folder with relevant subfiles.
    • Link sections of the documentation to one another, providing a coherent navigation experience.
    • Review the documentation for accuracy, clarity, and completeness before publishing it in the repository.

Acceptance Criteria:

Additional Context:

rifkybujana commented 3 weeks ago

https://developer.lsst.io/cpp/api-docs.html