 ;; has an alias, facts, for those of you who are sticklers about
 ;; grammar:
 
-(facts
+(facts "arithmetic"
  (+ 1 1) => 2
  (+ 1 0) => 1)
+
+;; Notice also that you can add "doc strings" to facts. Right now, they're just ignored.
 
 ;;
 ;; At the moment, midje uses the clojure.test reporting mechanism, so you can wrap

;; If you're testing something that produces a function, use
;; (exactly):

(fact (first [even? odd?]) => (exactly odd?))                      (note-expected)

;;     FAIL at (core_test.clj:57)
;;     Actual result did not pass expected function.

;;     expected: 3
;;       actual: 4

(fact ( #(+ 1 %) 3) => 3)                                          (note-expected-failure)

;; You can also use functions on the right-hand side. In that case,
;; the actual result is passed as the function's single argument.
(fact ( #(+ 1 %) 3) => odd?)                                       (note-expected-failure)
;; The failing test will look slighly different:
;;     FAIL at (core_test.clj:47)
;;     Actual result did not pass expected function.
