diff --git a/README.md b/README.md
index e7ad235..94340a5 100644
--- a/README.md
+++ b/README.md
@@ -13,9 +13,22 @@ Here is an example usage of **ziba.js**:
 <html>
 	<body>
 		<div id="main">
-			Hello world!
-
-			Here is a ziba-link to my rsume: <ziba-link>resume</ziba-link>
+			<p>
+				Hello world!
+			</p>
+			<p>
+				Here is a ziba-link to my <ziba-link>resume</ziba-link>.
+				That ziba-link will get turned into <a href="resume">resume</a>.
+				Notice that the text and the href are the same.
+			</p>
+			<p>
+				Here is another one <ziba-link title="four">fource</ziba-link>
+				This ziba tag will get turned into <a href="four">fource</a>
+				Notice that the href now has the value of the title of the ziba-link
+			</p>
+			<p>
+				ziba-link is design to work for only local links.
+			</p>
 		</div>
 
 		<script type="module">
