Skip to content

📝[Docs]: Improve and Add Missing README Files for Recommendation Models with Screenshots/Demo Videos #1490

@ananas304

Description

@ananas304

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

  1. Add detailed README.md files to folders where they are missing.
  2. 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

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions