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

Readme #37

Merged
merged 15 commits into from
Dec 12, 2023
1 change: 1 addition & 0 deletions .mdlrc
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
rules "~MD013, ~MD033"
51 changes: 50 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,12 @@
# cellveyor
<img src="https://github.com/GatorEducator/cellveyor/blob/master/.github/images/cellveyor-logo.svg" alt="Cellveyor Logo"
title="Cellveyor Logo" />

# Cellveyor

[![build](https://github.com/GatorEducator/cellveyor/actions/workflows/build.yml/badge.svg)](https://github.com/GatorEducator/cellveyor/actions/workflows/build.yml)
[![Code Style: black](https://img.shields.io/badge/Code%20Style-Black-blue.svg)](https://github.com/psf/black)
[![Maintenance](https://img.shields.io/badge/Maintained%3F-Yes-blue.svg)](https://github.com/gkapfham/chasten/graphs/commit-activity)
[![License LGPL v3](https://img.shields.io/badge/License-LGPL%20v3-blue.svg)](https://www.gnu.org/licenses/lgpl-3.0)

## Example Command

Expand All @@ -20,3 +28,44 @@ developer-development/feedback-overall-course-assessment.yml \
--github-repository-prefix computer-science-203-fall-2023-course-assessment \
--transfer-report
```

## 🎉 Introduction

- Cellveyor is a python program that produces assignment reports for students or
classes. Using Cellveyor will publicly give grade reports including feedback for
created assignments. Using the Cellveyor tool will quickly run and send reports to
members included in a locally created google spreadsheet. By running the command
created, this will quickly and automatically send out these reports in a very timely
and efficient fashion.

## 😂 Definitons

- Cellveyor is a tool that automatically produces a report based output by
analyzing a Google sheet
- Student sentence: "I'm glad Cellveyor made it easy for me to see my grades
from my classes, it's so easy to read and analyze."
- Instructor sentence: "Cellveyor makes it much easier for me to tell my
students what their grade looks like on a certain assignment or overall
in the class"
- Researchers sentence: "I found that Cellveyor is a very interesting tool that
quickly and automatically does a task that is necessary in schooling"

## 🔋Features

- 🚀 Fully customizable command line interface
- ✨ Automated generation of grade-based reports sent to students
- 🪂 Rich command line interface with many various arguments

## ⚡️ Requirements

- Cellveyor git hub repository
Copy link
Collaborator

Choose a reason for hiding this comment

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

This is a little nit-picky, but given that we're aiming to produce software that presents as professional-quality, it's worth noting that it should be GitHub (proper noun, one word).

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

fixed

- Local google sheet
- Git hub token

## 🔽 Installation

Follow these steps to install the Cellveyor program:
1. Copy the ssh key of the repo
2. ```Git clone``` the repository onto your personal computer
- ```git clone (ssh key)```
3. Type ```poetry run cellveyor --help``` to learn how to use the tool