-
Notifications
You must be signed in to change notification settings - Fork 111
Setup and Docs Need Improvement #442
Description
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:
-
Enhance Documentation: Include clear references and guides for the Python shell commands in the documentation.
-
Demo Video Improvement: In the demo video, demonstrate how to pass the repository in question along with the issue number.
-
Structured Setup Procedure: Reformat the setup instructions into a step-by-step guide to eliminate confusion and ambiguity.
-
Enhanced Support: Streamline the setup process to encourage more user engagement and support for the repository.
-
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"
-
Command Documentation: Document the shell commands thoroughly for easy user reference.
-
.env File Clarification: Clearly differentiate between mandatory and optional entries within the .env file in the documentation.