Improved README

README.md

@@ -1,23 +1,24 @@
 # PythonRMV
 
-Small module that makes your journey with RMV REST API somehow easier.
+Small module that makes your journey with RMV REST API somehow easier. Based fully on official RMV API reference and HAFAS documentation.
 
-# Get started
+# Requirements
 
-As you can guess you need to have RMV API key. You can get it for free on the [RMV website](https://opendata.rmv.de/site/start.html).
+* RMV API key (Get it [here](https://opendata.rmv.de/site/start.html))
-After that you also need to have Python3. I've tested all of that on Python 3.7.9 and Python 3.9.13.
+* Python3 (Tested versions are 3.7.9 and 3.9.13)
-Other versions should work too but I simply did not test it. Second python is not supported because why should it be.
+* git (Only for installation from source)
-Don't forget to install git. Of course you can download the repo without it but it's simply faster to use git.
 
 # Installation
 
-If you have all the listed in [Get started](#get-started), then let's begin.
+If you have everything listed in [requirements](#requirements), then let's begin.
 
-1. `git clone https://git.end-play.xyz/profitroll/PythonRMV.git`
+### Variant 1:
-2. `cd PythonRMV`
+1. `python -m pip install pyrmv`
-3. `python -m pip install -r requirements.txt`
 
-Done. You can now use everything that lays in PythonRMV.
+### Variant 2:
+1. `git clone https://git.end-play.xyz/profitroll/pyrmv.git`
+2. `cd pyrmv`
+3. `python setup.py install`
 
 # Frequently Asked Questions
 
@@ -28,29 +29,29 @@ Done. You can now use everything that lays in PythonRMV.
 ## Why are there raw versions and formatted ones?
 
 For the purposes of my projects I don't really need all the stuff RMV gives (even though it's not much).
-I only need some specific things and the rest I don't even need. However I do understand that in some
+I only need some specific things. However I do understand that in some cases other users may find
-cases other users may find those methods quite useful so I implemented them too.
+those methods quite useful so I implemented them as well.
 
 
 ## Some methods work slightly different
 
-Can be. Not all the arguments written may work perfectly because I simply did not test them all.
+Can be. Not all function arguments written may work perfectly because I simply did not test each and
-Some of them may be irrelevant in my use-case and the others are used quite rare at all.
+every request. Some of arguments may be irrelevant in my use-case and the others are used quite rare at all.
 Just [make an issue](https://git.end-play.xyz/profitroll/PythonRMV/issues/new) and I'll implement it correct when I'll have some free time.
 
 ## Documentation is not perfectly clear
 
-Of course docs cannot be perfect in the format of python docstring, especially if I also don't always
+Of course docs cannot be perfect as a python docstring, especially if sometimes I don't
-know how things should correctly work so that's why you get HAFAS API docs together with your
+know how things should correctly work. That's why you get HAFAS API docs in addition to your
-RMV API key. Just use my functions in connection with those docs, if you want to build something
+RMV API key. Just use my functions together with those docs, if you want to build something
-actually sophisticated. But remember, that I wrote all of that without sophistication in mind.
+really sophisticated. However I'm not sure whether RMV supports that many HAFAS features publicly.
 
 # To-Do
-[ ] arrivalBoard (boardArrival)  
+- [ ] arrivalBoard (boardArrival)  
-[ ] departureBoard (boardArrival)  
+- [ ] departureBoard (boardArrival)  
-[*] himsearch (himSearch)  
+- [x] himsearch (himSearch)  
-[ ] journeyDetail  
+- [ ] journeyDetail  
-[*] location.nearbystops (stopByCoords)  
+- [x] location.nearbystops (stopByCoords)  
-[*] location.name (stopByName)  
+- [x] location.name (stopByName)  
-[ ] recon  
+- [ ] recon  
-[*] trip (findRoute)  
+- [x] trip (findRoute)