Finish readme

Author: tsolomko

BitByteData.podspec

@@ -2,9 +2,9 @@ Pod::Spec.new do |s|
 
   s.name         = "BitByteData"
   s.version      = "1.0.0-test.3"
-  s.summary      = "Read and write bits and bytes from data consequently in Swift."
+  s.summary      = "Read and write bits and bytes in Swift."
 
-  s.description  = "A Swift framework with functions for reading and writing bytes and bits."
+  s.description  = "A Swift framework with classes for reading and writing bits and bytes."
 
   s.homepage     = "https://github.com/tsolomko/BitByteData"
   s.documentation_url = "http://tsolomko.github.io/BitByteData"

README.md

@@ -4,12 +4,14 @@
 [![GitHub license](https://img.shields.io/badge/license-MIT-lightgrey.svg)](https://raw.githubusercontent.com/tsolomko/BitByteData/master/LICENSE)
 [![Build Status](https://travis-ci.org/tsolomko/BitByteData.svg?branch=develop)](https://travis-ci.org/tsolomko/BitByteData)
 
-A Swift framework with classes for reading and writing bytes and bits.
+A Swift framework with classes for reading and writing bits and bytes.
 
 ## Installation
 
-Right now only Swift Package manager is supported.
-(Carthage and CocoaPods will be available at the 1.0 release).
+BitByteData can be integrated into your project using Swift Package Manager, CocoaPods or Carthage.
+
+### Swift Package Manager
+
 To install using SPM, add BitByteData to you package dependencies
 and specify it as a dependency for your target, e.g.:
 
@@ -33,9 +35,34 @@ let package = Package(
 
 More details you can find in [Swift Package Manager's Documentation](https://github.com/apple/swift-package-manager/tree/master/Documentation).
 
+### CocoaPods
+
+Add `pod 'BitByteData', '~> 1.0'` and `use_frameworks!` lines to your Podfile.
+
+To complete installation, run `pod install`.
+
+### Carthage
+
+Add to your Cartfile `github "tsolomko/BitByteData" ~> 1.0`.
+
+Then run `carthage update`.
+
+Finally, drag and drop `BitByteData.framework` from `Carthage/Build` folder
+into the "Embedded Binaries" section on your targets' "General" tab in Xcode.
+
 ## Usage
 
-TBD.
+Use `ByteReader` class to read bytes.
+For reading bits there are two classes: `LsbBitReader` and `MsbBitReader`, which implement `BitReader` protocol
+for two bit-numbering schemes ("LSB 0" and "MSB 0" correspondingly).
+Both `LsbBitReader` and `MsbBitReader` classes inherit from `ByteReader` so you can also use them to read bytes
+(but they must be aligned, see documentation for more details).
+
+Writing bits is implemented in two classes `LsbBitWriter` and `MsbBitWriter` (again, for two bit-numbering schemes).
+They both conform to `BitWriter` protocol.
+
+__Note:__ All readers and writers aren't structs, but classes intentionally.
+This is done to make it easier to pass them as arguments to functions and to eliminate unnecessary copying and `inout`s.
 
 ## Documentation
 
@@ -48,3 +75,6 @@ Whether you find a bug, have a suggestion, idea or something else,
 please [create an issue](https://github.com/tsolomko/BitByteData/issues) on GitHub.
 
 If you'd like to contribute code, please [create a pull request](https://github.com/tsolomko/BitByteData/pulls) on GitHub.
+
+__Note:__ If you are considering working on BitByteData, please note that Xcode project (BitByteData.xcodeproj)
+was created manually and you shouldn't use `swift package generate-xcodeproj` command.