Skip to content
This repository was archived by the owner on Sep 26, 2024. It is now read-only.
This repository was archived by the owner on Sep 26, 2024. It is now read-only.

Improve Documentation #1

@Cruiz102

Description

@Cruiz102

Overview

Currently, our README lacks comprehensive documentation on several key aspects of our project. This issue aims to address these gaps to improve user understanding and ease of use.

Specific Areas for Improvement

  1. Detailed Documentation of config/topics.yaml
    Problem: The file config/topics.yaml contains a list of topics that subscribers are reading. However, the current README does not provide a full list or explain these topics in detail.
    Proposed Solution: Update the README to include:
    A complete list of topics available in config/topics.yaml.
    A brief description of what each topic covers.
    Information on the services available for each topic.
  2. Instructions for Building and Running the Software
    Problem: There are no clear instructions for building and running our software.
    Proposed Solution: Add a new section in the README or in separate documentation that includes:
    Step-by-step instructions for building the software.
    Guidelines on how to run the software effectively.
  3. Hardware Requirements
    Problem: Users are currently not informed about the hardware requirements needed to run our software.
    Proposed Solution: Provide a detailed list of hardware requirements. This should include:
    Minimum hardware specifications.
    Recommended specifications for optimal performance.

Additional Suggestions

GitHub Repository Configuration: I'm open to suggestions for configuring the GitHub repository to better accommodate these documentation improvements.
Feedback and Contributions: Ideas and contributions from the community to enhance our current documentation are highly welcomed and appreciated.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions