Added docs to RxTest methods

Source/RxTest/Equal+RxTest.swift

@@ -2,6 +2,7 @@ import Nimble
 import RxSwift
 @testable import RxTest
 
+/// A Nimble matcher that succeeds when the actual events are equal to the expected events.
 public func equal<T: Equatable>(_ expectedEvents: RecordedEvents<T>) -> Predicate<RecordedEvents<T>> {
     return Predicate.define { actualEvents in
         let actualEquatableEvents = try actualEvents.evaluate()?.map { AnyEquatable(target: $0, comparer: ==) }

Source/RxTest/Expectation+RxTest.swift

@@ -5,6 +5,13 @@ import RxTest
 public typealias RecordedEvents<E> = [Recorded<Event<E>>]
 
 public extension Expectation where T: ObservableType {
+    /// Make an expectation on the events emitted by an observable.
+    ///
+    /// - Parameters:
+    ///   - scheduler: the scheduler used to record events in virtual time units.
+    ///   - disposeBag: the dispose bag that will dispose all of its resources between tests.
+    ///   - initialTime: the time at which subscription/recording should begin.
+    /// - Returns: an expectation of the actual events emitted by the observable.
     func events(scheduler: TestScheduler,
                 disposeBag: DisposeBag,
                 startAt initialTime: Int = 0) -> Expectation<RecordedEvents<T.E>> {

Source/RxTest/ThrowError+RxTest.swift

@@ -2,6 +2,8 @@ import Nimble
 import RxSwift
 import RxTest
 
+/// A Nimble matcher that succeeds when the actual events emit an error
+/// of any type.
 public func throwError<T: Equatable>() -> Predicate<RecordedEvents<T>> {
     func extractError(_ recorded: RecordedEvents<T>?) -> [Error]? {
         func extractError<E>(_ recorded: Recorded<Event<E>>) -> Error? {