diff --git a/src/main/java/org/assertj/core/api/AbstractBooleanAssert.java b/src/main/java/org/assertj/core/api/AbstractBooleanAssert.java
index b2869cbc110..94c74bcafe9 100644
--- a/src/main/java/org/assertj/core/api/AbstractBooleanAssert.java
+++ b/src/main/java/org/assertj/core/api/AbstractBooleanAssert.java
@@ -41,6 +41,15 @@ protected AbstractBooleanAssert(Boolean actual, Class<?> selfType) {
 
   /**
    * Verifies that the actual value is {@code true}.
+   * <p/>
+   * Example:
+   * <pre><code class='java'> // assertions will pass
+   * assertThat(true).isTrue();
+   * assertThat(Boolean.TRUE).isTrue();
+   *
+   * // assertions will fail
+   * assertThat(false).isTrue();
+   * assertThat(Boolean.FALSE).isTrue();</code></pre>
    * 
    * @return {@code this} assertion object.
    * @throws AssertionError if the actual value is {@code null}.
@@ -52,6 +61,15 @@ public S isTrue() {
 
   /**
    * Verifies that the actual value is {@code false}.
+   * <p/>
+   * Example:
+   * <pre><code class='java'> // assertions will pass
+   * assertThat(false).isFalse();
+   * assertThat(Boolean.FALSE).isFalse();
+   *
+   * // assertions will fail
+   * assertThat(true).isFalse();
+   * assertThat(Boolean.TRUE).isFalse();</code></pre>
    * 
    * @return {@code this} assertion object.
    * @throws AssertionError if the actual value is {@code null}.
@@ -63,6 +81,15 @@ public S isFalse() {
 
   /**
    * Verifies that the actual value is equal to the given one.
+   * <p/>
+   * Example:
+   * <pre><code class='java'> // assertions will pass
+   * assertThat(true).isEqualTo(true);
+   * assertThat(Boolean.FALSE).isEqualTo(false);
+   * 
+   * // assertions will fail
+   * assertThat(true).isEqualTo(false);
+   * assertThat(Boolean.TRUE).isEqualTo(false);</code></pre>
    * 
    * @param expected the given value to compare the actual value to.
    * @return {@code this} assertion object.
@@ -76,6 +103,15 @@ public S isEqualTo(boolean expected) {
 
   /**
    * Verifies that the actual value is not equal to the given one.
+   * <p/>
+   * Example:
+   * <pre><code class='java'> // assertions will pass
+   * assertThat(true).isNotEqualTo(false);
+   * assertThat(Boolean.FALSE).isNotEqualTo(true);
+   *
+   * // assertions will fail
+   * assertThat(true).isNotEqualTo(true);
+   * assertThat(Boolean.FALSE).isNotEqualTo(false);</code></pre>
    * 
    * @param other the given value to compare the actual value to.
    * @return {@code this} assertion object.
diff --git a/src/main/java/org/assertj/core/api/AbstractByteAssert.java b/src/main/java/org/assertj/core/api/AbstractByteAssert.java
index 6d3e0aeade2..ef9d64a5532 100644
--- a/src/main/java/org/assertj/core/api/AbstractByteAssert.java
+++ b/src/main/java/org/assertj/core/api/AbstractByteAssert.java
@@ -46,7 +46,16 @@ protected AbstractByteAssert(Byte actual, Class<?> selfType) {
 
   /**
    * Verifies that the actual value is equal to the given one.
+   * <p/>
+   * Example:
+   * <pre><code class='java'> // assertions will pass
+   * assertThat((byte) 1).isEqualTo((byte) 1);
+   * assertThat((byte) 0).isEqualTo(Byte.valueOf("0"));
    * 
+   * // assertions will fail
+   * assertThat((byte) 1).isEqualTo((byte) 0);
+   * assertThat(Byte.valueOf("1")).isEqualTo((byte) 0);</code></pre>
+   *
    * @param expected the given value to compare the actual value to.
    * @return {@code this} assertion object.
    * @throws AssertionError if the actual value is {@code null}.
@@ -59,6 +68,15 @@ public S isEqualTo(byte expected) {
 
   /**
    * Verifies that the actual value is not equal to the given one.
+   * <p/>
+   * Example:
+   * <pre><code class='java'> // assertions will pass
+   * assertThat((byte) 0).isNotEqualTo((byte) 1);
+   * assertThat(Byte.valueOf("1")).isNotEqualTo((byte) 0);
+   * 
+   * // assertions will fail
+   * assertThat((byte) 0).isNotEqualTo((byte) 0);
+   * assertThat(Byte.valueOf("0")).isNotEqualTo((byte) 0);</code></pre>
    * 
    * @param other the given value to compare the actual value to.
    * @return {@code this} assertion object.
diff --git a/src/main/java/org/assertj/core/api/AbstractInputStreamAssert.java b/src/main/java/org/assertj/core/api/AbstractInputStreamAssert.java
index 652975665cb..49440c44b1e 100644
--- a/src/main/java/org/assertj/core/api/AbstractInputStreamAssert.java
+++ b/src/main/java/org/assertj/core/api/AbstractInputStreamAssert.java
@@ -58,7 +58,15 @@ public S hasContentEqualTo(InputStream expected) {
 
   /**
    * Verifies that the content of the actual {@code InputStream} is equal to the content of the given one.
+   * <p/>
+   * Example:
+   * <pre><code class='java'> // assertion will pass
+   * assertThat(new ByteArrayInputStream(new byte[] {0xa})).hasSameContentAs(new ByteArrayInputStream(new byte[] {0xa}));
    *
+   * // assertions will fail
+   * assertThat(new ByteArrayInputStream(new byte[] {0xa})).hasSameContentAs(new ByteArrayInputStream(new byte[] {}));
+   * assertThat(new ByteArrayInputStream(new byte[] {0xa})).hasSameContentAs(new ByteArrayInputStream(new byte[] {0xa, 0xc, 0xd}));</code></pre>
+   * 
    * @param expected the given {@code InputStream} to compare the actual {@code InputStream} to.
    * @return {@code this} assertion object.
    * @throws NullPointerException if the given {@code InputStream} is {@code null}.