From f394de681d7d616a729a79f3e312be34f0df6119 Mon Sep 17 00:00:00 2001 From: mateuszplaza <73618664+mateuszplaza@users.noreply.github.com> Date: Wed, 27 Sep 2023 18:55:05 -0400 Subject: [PATCH] Update README.md Added site usage info, script descriptions, and linked to live site and documentation. --- README.md | 37 ++++++++++++++++++++++++++++++++++--- 1 file changed, 34 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index a4a0a2c..2961ece 100644 --- a/README.md +++ b/README.md @@ -2,12 +2,34 @@ A web app to help students at the University of Florida plan classes for the semester. +Swamp Scheduler currently allows students to explore UF's schedule of courses, make course selections, and generate schedules that fit their needs. + ## Table of Contents -- [Usage](#Usage) +- [App](#app) +- [Usage](#usage) - [Maintainers](#maintainers) +- [Documentation](#documentation) - [License](#license) +## App + +[Link](https://osc.rconde.xyz/) + +Course Search: +- You can select a term (ie. Fall 2023) from the dropdown on the top right. +- At the top left there is a search bar for courses +- Using the drop-down, select whether you would like to search by course code or name +- Once you search, courses matching that query will appear in the left bar. There is a course code, name, description, and credit load. +- Underneath that you will find available sections. Each section contains information about the meeting times, instructor(s), and periods. +- If you click on a class period, a link will take you to the UF campus map highlighting the class location + +Schedule: +- When you select a course, it appears in your courses in the center pane +- If you would like to add more courses, click on 'Add Course' +- As you add more courses, schedule options are generated in the right pane +- You can select a limit for how many shedules to generate + ## Usage To run the development server locally: @@ -15,13 +37,22 @@ To run the development server locally: - `npm install` - `npm run start` -`npm run build` will build the app to `./dist`. +Scripts: +- dev: Starts Vite dev server in the current directory +- build: builds the app to `./dist` +- preview: previews a specific build, starting it on a local port +- check-format: checks all formatting with prettier and displays warnings +- fix-format: attempts to fix formatting issues ## Maintainers - [Robert Conde](https://github.com/RobertConde) - [Brian Nielsen](https://github.com/bnielsen1) +## Documentation + +For more documentation, see [OSC Docs Website](https://docs.ufosc.org/docs/swamp-scheduler) + ## License -GNU Affero General Public License v3.0 \ No newline at end of file +GNU Affero General Public License v3.0