Finish readme

This commit is contained in:
Tobias Eidelpes 2020-06-21 11:28:41 +02:00
parent fd49d87840
commit 6259493e8d

109
README.md
View File

@ -1,75 +1,58 @@
# Tiss2Go - User Guide
# Tiss2Go
Tiss2Go is a ruby on rails gateway server for the TISS (TU Wien Informations-Systeme und Services) application.
It was made for the course _Ruby on Rails Business Programming_ for 2020SS.
Tiss2Go is a ruby on rails gateway server for the TISS (TU Wien
Informations-Systeme und Services) application. It was made for the course
_Ruby on Rails Business Programming_ for 2020SS.
It offers an easy and mobile friendly interface for searching through the TISS API.
Searchable are TU related subjects like people, courses, available theses and projects.
It offers an easy and mobile friendly interface for searching through the TISS
API. Searchable are TU related subjects like people, courses, available theses
and projects.
To be able to use the Tiss2Go application, one must create a personal user account
consisting of a username, which is represented by the email and a password.
## User Guide
After logging in, the user is redirected directly on the main search view.
Here, the user can input a search term and check his/her search topic
with the radio buttons directly below the input field.
Empty searches are not allowed and therefore blocked!
To be able to use the Tiss2Go application, one must create a personal user
account consisting of a username, which is represented by an email address, and
a password.
The search is then computed and provides the user with the results, if it could find something.
Found items can be directly favorited with the "heart"-button or the corresponding
detail view can directly be accessed by "touching"/"clicking" on the entry.
After logging in, the user is redirected to the main search view. Here, the
user can input a search term and check his/her search topic with the radio
buttons directly below the input field. Empty searches are not allowed and
therefore blocked!
On the detail view the user can also add the subject to the related favorites and if
the subject is favorited, can also save annotations and keywords.
The search is then computed and provides the user with the results, if it could
find something. Found items can be favorited with the _heart_-button or the
corresponding detail view can directly be accessed by _touching_/_clicking_ on
the entry.
On the detail view the user can also add the subject to the related favorites
and if the subject is favorited, can also save annotations and keywords.
Through the main navigation bar the stored favorites can be accessed easily.
The favorites themselves are also grouped in people, courses, theses and projects.
If favorites are stored, the main subject view presents the stored information
in a table like view. The entries can be sorted either ascending or descending
by clicking on the corresponding table header.
The entries can also be deleted directly in this view and it is possible to access
the related details view, too.
The favorites themselves are also grouped in people, courses, theses and
projects. If favorites are stored, the main subject view presents the stored
information in a table-like view. The entries can be sorted either ascendingly
or descendingly by clicking on the corresponding table header. The entries can
also be deleted directly in this view and it is possible to access the related
details view, too.
If the user wants to print his/her favorites, it can also be done directly by pressing
the PRINT button in the favorites main menu. A toggle beneath allows for
hiding/displaying the stored annotations.
If the user wants to print his/her favorites, it can also be done directly by
pressing the PRINT button in the favorite's main menu. A toggle beneath allows
for hiding/displaying the stored annotations.
If wanted the user can also print the detail view with a print button on the detail view.
The user can also print the detail view with a print button on the detail view.
# Authors
Eidelpes Tobias - 0
## Requirements
- Ruby version 2.7.0
- Rails version 6.0.2.1
## SETUP
- `rake db:create`
- `rake db:migrate`
- `rails server`
## Authors
Eidelpes Tobias - 01527193
Zeisler Marco - 01628030
# META
Used rails version: 2.7.0p0
Used ruby version: 6.0.2.1
# SETUP
'rake db:create'
'rake db:migrate'
'rails server'
# README
This README would normally document whatever steps are necessary to get the
application up and running.
Things you may want to cover:
* Ruby version
* System dependencies
* Configuration
* Database creation
* Database initialization
* How to run the test suite
* Services (job queues, cache servers, search engines, etc.)
* Deployment instructions
* ...