From 3a4fe8e4076083c1bf0e6c930954ec58633114a5 Mon Sep 17 00:00:00 2001
From: Jacek Kowalski <Jacek@jacekk.info>
Date: Mon, 02 Nov 2020 22:35:50 +0000
Subject: [PATCH] [map] Fix vehicle search

---
 README.md |   69 ++++++++++++++++++++++++++++++++++
 1 files changed, 68 insertions(+), 1 deletions(-)

diff --git a/README.md b/README.md
index 42506ee..2f60e45 100644
--- a/README.md
+++ b/README.md
@@ -5,11 +5,78 @@
 
 Check https://mpk.jacekk.net/ for a live version.
 
+Contact and suggestions: mpk_AT_jacekk.info
+
+[![Build Status](https://travis-ci.org/jacekkow/mpk-ttss.svg?branch=master)](https://travis-ci.org/jacekkow/mpk-ttss)
+[![Codacy Badge](https://api.codacy.com/project/badge/Grade/530c81cbab3449a9b24327591361bec8)](https://www.codacy.com/app/jacekkow/mpk-ttss)
+
 ## Differences
 
-* Displays traffic alerts.
 * Presents tram delays.
 * Lists lines passing through selected stop.
+* Improved autocompletion.
+
+## Usage
+
+### Changing language
+
+You can change the interface language using the dropdown near "TTSS Kraków" header.
+Currently only Polish (PL) and English (EN) translations are available.
+
+### Selecting the stop
+
+Enter first letter of a stop name into the input field labeled as "Stop name".
+Suggestions will be displayed in the dropdown located to the right.
+
+Each name component is matched separately (case-insensitive), so:
+
+- "ba" matches "Teatr Bagatela",
+- "d g" matches "Dworzec Główny", "Dworzec Główny Tunel" and "Dworzec Główny Zachód",
+- "aleja" matches "M1 Al. Pokoju" and "TAURON Arena Kraków Al. Pokoju",
+- "święt" matches "Plac Wszystkich Świętych", "Św.Gertrudy" and "Św.Wawrzyńca".
+
+When the selected suggestion in the dropdown matches the desired stop,
+click the "Go" button or (alternatively) press the ENTER key.
+
+### Display
+
+After selecting the stop, the following information are visible:
+
+- Line - line number,
+- Direction - final stop on the line,
+- Time - predicted/scheduled departure time,
+- Delay - calculated delay from the schedule.
+
+Relative times (eg. 3 min) are real-time arrivals based on tram location data.
+Absolute times (eg. 8:01) are scheduled departures, shown when the tram cannot be located.
+
+To the left of the time is an icon representing the tram type:
+♿ - low-floor tram,
+*♿ - partially low-floor tram,
+‐ - high-floor tram.
+Hover over an icon to show the tooltip with tram identifier and vehicle type.
+
+Rows have different background depending on the tram status:
+- green - at the stop,
+- white - en-route,
+- yellow - delayed 4 or more minutes,
+- red - delayed 10 or more minutes.
+
+Clicking on the table row loads the schedule for the selected tram
+- listing next stops and predicted departure times for each one.
+
+### Auto-refresh
+
+The list is automatically updated every 20 seconds. It is possible to manually
+reload the data using the "Refresh" button.
+
+When an error occurs, automatic update is disabled and manual refresh is required.
+This event is indicated by the red message box just over the stop name.
+
+### Bookmarks
+
+Changing the language or selecting a stop causes the address to change.
+You may bookmark the address to avoid entering the data each time.
 
 ## License
 

--
Gitblit v1.9.1