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

Setup and Docs Need Improvement #442

@JustScriptin

Description

@JustScriptin

The documentation lacks clear references to Python shell commands, making them particularly difficult to locate. The only shell commands I could identify were presented in the demo video, but there was no apparent flag for specifying the repository in question - just the issue number. Additionally, the setup procedure lacks a structured, step-by-step format, which leads to a significant amount of guesswork.

Improving the accessibility of the setup process could likely garner more support for this repository. Unfortunately, the current documentation is far from helpful. A worthwhile consideration might be to introduce a Docker development environment, alleviating users from grappling with OS-related issues. Alongside this, the shell commands should be well-documented and distinctions made clear between mandatory and optional elements within the .env file.

TL;DR:

  1. Enhance Documentation: Include clear references and guides for the Python shell commands in the documentation.

  2. Demo Video Improvement: In the demo video, demonstrate how to pass the repository in question along with the issue number.

  3. Structured Setup Procedure: Reformat the setup instructions into a step-by-step guide to eliminate confusion and ambiguity.

  4. Enhanced Support: Streamline the setup process to encourage more user engagement and support for the repository.

  5. Docker Development Environment: Consider introducing a Docker development environment to free users from OS-related issues. Not only as a means to run the shell. This requires adding a ".devcontainer"

  6. Command Documentation: Document the shell commands thoroughly for easy user reference.

  7. .env File Clarification: Clearly differentiate between mandatory and optional entries within the .env file in the documentation.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions