Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Updates README and USAGE for improved readability #101

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

brstuder
Copy link

Makes several noticeable changes to README and USAGE which do the following:

  • Places project objectives and description in README instead of USAGE
  • Removes duplicate deployment notes and instructions from USAGE and organizes them into README
  • Improves readability and technical formatting
  • Reworks USAGE to solely focus on front-end accessibility and function

@pradeepsen99 pradeepsen99 self-requested a review November 22, 2024 23:06
Copy link
Collaborator

@pradeepsen99 pradeepsen99 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Had a q on the note and a non blocking nit.

Comment on lines +92 to +93
> [!NOTE]
> This section can be further expanded on to include any external models as needed.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not sure what the purpose of this is


## Goals
The goal of this project is to create a tool that is easy to use, has a small learning curve and can scale easily to provide the ability to annotate videos efficiently and at scale. The intuition of this project is gained from analyzing similar projects and analyzing the weaknesses and points of frustration and improving them. Another goal is to have an annotation workflow that is extremely fast and efficient, as there are terabytes of video that needs to be processed at large.
For a system that spans multiple academic disciplines, ensuring a robust interface allows a person of any experience to efficiently annotate videos. A potential user should be able to identify animals of interest easily and have a method to track them across frames in an easy and efficient manner. For a more efficient workflow, a series of key bindings was implemented to expedite each operation within the platform, therefore allowing unexperienced users to familiarize themselves with a predetermined workflow efficiently.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: this info was in the Usage but sounds awkward when placed here. Might need to be split up and parts merged into the intro and goals

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants