diff --git a/lib/scripts/behaviour.js b/lib/scripts/behaviour.js
index aadf74a1ca94c341055f77d6d91faea93c753f75..6012e5d1d21991b606082ea635f905e2f3f1b582 100644
--- a/lib/scripts/behaviour.js
+++ b/lib/scripts/behaviour.js
@@ -112,14 +112,31 @@ var dw_behaviour = {
 
 };
 
+/**
+ * Hides elements with a slide animation
+ *
+ * @param fn optional callback to run after hiding
+ * @author Adrian Lang <mail@adrianlang.de>
+ */
 jQuery.fn.dw_hide = function(fn) {
     return this.slideUp('fast', fn);
 };
 
-jQuery.fn.dw_show = function() {
-    return this.slideDown('fast');
+/**
+ * Unhides elements with a slide animation
+ *
+ * @param fn optional callback to run after hiding
+ * @author Adrian Lang <mail@adrianlang.de>
+ */
+jQuery.fn.dw_show = function(fn) {
+    return this.slideDown('fast', fn);
 };
 
+/**
+ * Toggles visibility of an element using a slide element
+ *
+ * @param bool the current state of the element (optional)
+ */
 jQuery.fn.dw_toggle = function(bool) {
     return this.each(function() {
         var $this = jQuery(this);