Merge pull request #26 from SimonFrings/docs

Improve documentation and minor clean up

Author: clue

.gitignore

@@ -1,2 +1,2 @@
-/vendor/
 /composer.lock
+/vendor/

README.md

@@ -35,7 +35,11 @@ It wraps a given `ReadableStreamInterface` and exposes its data through the same
 interface.
 
 ```php
-$stdin = new ReadableResourceStream(STDIN, $loop);
+<?php
+
+require __DIR__ . '/vendor/autoload.php';
+
+$stdin = new ReadableResourceStream(STDIN);
 
 $stream = new Sequencer($stdin);
 
@@ -67,7 +71,7 @@ This binary data will be left as-is, unless you filter this at a later stage.
 
 ## Install
 
-The recommended way to install this library is [through Composer](https://getcomposer.org).
+The recommended way to install this library is [through Composer](https://getcomposer.org/).
 [New to Composer?](https://getcomposer.org/doc/00-intro.md)
 
 This project follows [SemVer](https://semver.org/).
@@ -82,12 +86,12 @@ See also the [CHANGELOG](CHANGELOG.md) for details about version upgrades.
 This project aims to run on any platform and thus does not require any PHP
 extensions and supports running on legacy PHP 5.3 through current PHP 8+ and
 HHVM.
-It's *highly recommended to use PHP 7+* for this project.
+It's *highly recommended to use the latest supported PHP version* for this project.
 
 ## Tests
 
 To run the test suite, you first need to clone this repo and then install all
-dependencies [through Composer](https://getcomposer.org):
+dependencies [through Composer](https://getcomposer.org/):
 
 ```bash
 $ composer install
@@ -96,7 +100,7 @@ $ composer install
 To run the test suite, go to the project root and run:
 
 ```bash
-$ php vendor/bin/phpunit
+$ vendor/bin/phpunit
 ```
 
 ## License

src/Sequencer.php

@@ -4,8 +4,8 @@
 
 use Evenement\EventEmitter;
 use React\Stream\ReadableStreamInterface;
-use React\Stream\WritableStreamInterface;
 use React\Stream\Util;
+use React\Stream\WritableStreamInterface;
 
 /**
  * forwards only complete UTF-8 sequences