add example file

Author: kavaliero

example/yoda.js

@@ -0,0 +1,24 @@
+({
+	auth:function(){return auth({provider:fs('/bin/yoda')})},
+/** 
+ * @category All
+ * @param {string} [sentence] Input sentence to turn into Yoda-speak
+ * @methodhttp GET
+ */
+	'YodaSpeak': function(args, opts) {
+		var url = 'https://yoda.p.mashape.com/yoda'
+		args = args || {}
+		if (args['sentence'] == null) throw new Error('sentence is a required parameter')
+		var rgx = new RegExp('\{sentence\}', 'g')
+		if (url.match(rgx)) {
+			url = url.replace(rgx, args['sentence'])
+			if (args['sentence']) delete args['sentence']
+		}
+		if (url.indexOf('[/sentence]') !== -1) {
+			url = url.replace('[/sentence]', '/' + args['sentence'])
+			if (args['sentence']) delete args['sentence']
+		}
+		if (url.indexOf('[/sentence]') !== -1) url = url.replace('[/sentence]', '')
+		return http({provider:fs('/bin/yoda'),url:url,method:'GET',params:args}, opts)
+	}
+})

example/yoda.wadl

@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<application xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+xmlns:xsd="http://www.w3.org/2001/XMLSchema"
+xmlns:apigee="http://api.apigee.com/wadl/2010/07/"
+xmlns="http://wadl.dev.java.net/2009/02" xmlns:t="urn:github:githubresponse"
+xmlns:webshell="http://webshell.io/wadl/2012/06/"
+xsi:schemaLocation="http://wadl.dev.java.net/2009/02 http://apigee.com/schemas/wadl-schema.xsd http://api.apigee.com/wadl/2010/07/ http://apigee.com/schemas/apigee-wadl-extensions.xsd http://webshell.io/wadl/2012/06/ http://webshell.io/wadl/webshell-extensions.xsd">
+<resources base="https://yoda.p.mashape.com">
+<resource path="/yoda">
+<method id="YodaSpeak" name="GET">
+<apigee:tags>
+<apigee:tag primary="true">All</apigee:tag>
+</apigee:tags>
+<webshell:authentication required="true"/>
+<doc></doc>
+<request>
+<param name="sentence" required="true" type="string" style="query">
+<doc>
+Input sentence to turn into Yoda-speak</doc>
+</param>
+</request>
+</method>
+</resource>
+</resources>
+</application>

pages/add-your-api.html

@@ -43,6 +43,7 @@ <h2>Wrapper in Javascript</h2>
 <section id="generate-from-wadl">
   <h2>Generate from WADL</h2>
     <p>WADL is a standard for describing REST API using a XML file. We've made a builtin which generate javascript compatible with Webshell from a WADL File</p>
+    <a href="https://webshell.github.io/docs/example/yoda.wadl"></a>
   <pre class="prettyprint">wadl({
   xml: fs.username.path['wadl.xml'],
   target: fs.username.apiName
@@ -52,11 +53,12 @@ <h2>Generate from WADL</h2>
   <p>As the documentation of the API is contained in the WADL File, we generate HTML files to make a pretty and simple docs. To read documentation, use <code>docs()</code> builtin function</p>
   <p> At the end we have a js file and a docs directory with all the HTML file : </p>
  <img src="http://webshell.github.io/docs/images/webshell-wadl.png" />
+ <a href="https://webshell.github.io/docs/example/yoda.js"></a>
 </section>
 <section id="generate-from-mashape">
   <h2>Generate from Mashape XML File</h2>
     <p>Mashape is an API Hub with an API to access their API description. This XML is based on any standard but was made nicely. Authentication information is available in the XML so, we generate for you the configuration file (conf.json)</p>
-    <p>The mashape builtin generate a wadl file, then we call the wadl builtin to general all the js and documentation for the api </p>
+    <p>The mashape builtin generate a wadl file, then we call the wadl builtin to generate all the js and documentation for the api </p>
   <pre class="prettyprint">mashape({
   xml: fs.username.path['mashape-api.xml'],
   output: fs.username.apiName