-
Notifications
You must be signed in to change notification settings - Fork 329
Description
Is there an existing issue for this?
- I have searched the existing issues
Issue Description
The folders and files under the Recommendation Models directory either have missing README.md
files or the existing documentation lacks sufficient details. Specifically, there are no screenshots or demo videos to guide users through the functionality or provide visual aid for project understanding.
Suggested Change
- Add detailed
README.md
files to folders where they are missing. - Enhance existing
README.md
files to include:- Clear descriptions of each project.
- How to run the projects with step-by-step instructions.
- Necessary dependencies or files required for smooth execution.
- Screenshots and demo videos to demonstrate the functionality of the models.
- Explanations of the algorithms used and their practical applications.
Rationale
Comprehensive documentation, along with visual aids, will help users understand the project flow better and make it easier to replicate or extend the models. Adding the necessary files and ensuring everything is working properly will enhance the overall user experience and provide clarity on the functionality of the recommendation systems.
Additional Context:
The following folders need updates:
- Book Recommendation System: Missing
README.md
, requirements.txt and detailed instructions. - Facial Expression Recognition with PyTorch: Lacks detailed
README.md
and sample video to test the code. - Music Recommendation: Update existing
README.md
to include more detailed steps. - Restaurant Recommender : Make sure the README.md files are comprehensive, featuring installation instructions and visual elements like screenshots or videos.
- Sentence AutoCompletion: Ensure
README.md
files are detailed, include installation instructions, and visual aids such as screenshots or videos.
Ensuring all projects are properly documented and working will also benefit future contributors.
Could we consider promoting me to Level 2, as I believe my contributions and the additional responsibilities I’ve taken on align well with that level.
assign to @ananas304 with appropriate tags. Thankyou for your time :)
Urgency
Medium
Record
- I have read the Contributing Guidelines
- I'm a GSSOC'24 contributor
- I want to work on this issue