Document legacy Generator.extend method properly - rel #996

lib/index.js

@@ -739,10 +739,16 @@ Base.prototype._writeFiles = function (done) {
 };
 
 /**
- * Extend this Class to create a new one inherithing this one.
- * Also add a helper \_\_super__ object pointing to the parent prototypes methods
+ * Extend the Generator class to create a new one inherithing the base one. This
+ * method is useful if your environment do not suport the ES6 classes.
  * @param  {Object} protoProps  Prototype properties (available on the instances)
  * @param  {Object} staticProps Static properties (available on the contructor)
  * @return {Object}             New sub class
+ * @example
+ * var Generator = require('yeoman-generator');
+ * module.exports = Generator.extend({
+ *   writing: function () {}
+ *   // ...
+ * });
  */
 Base.extend = require('class-extend').extend;