CORRECT readme for knobs && change comment on deprecating requiring @…

…storybook/addon-knobs directly

addons/knobs/README.md

@@ -256,9 +256,9 @@ Usage:
 ```js
 import { storiesOf } from '@storybook/react';
 
-const stories = storiesOf('')
+const stories = storiesOf('Storybook Knobs', module);
 
-story.addDecorator(withKnobsOptions({
+stories.addDecorator(withKnobsOptions({
   debounce: { wait: number, leading: boolean}, // Same as lodash debounce.
   timestamps: true // Doesn't emit events while user is typing.
 }));

addons/knobs/src/index.js

@@ -14,9 +14,8 @@ deprecate(
   'Using @storybook/addon-knobs directly is discouraged, please use @storybook/addon-knobs/{{framework}}'
 );
 
-// "Higher order component" / wrapper style API
-// In 3.3, this will become `withKnobs`, once our decorator API supports it.
-// See https://github.com/storybooks/storybook/pull/1527
+// generic higher-order component decorator for all platforms - usage is discouraged
+// This file Should be removed with 4.0 release
 function wrapperKnobs(options) {
   const channel = addons.getChannel();
   manager.setChannel(channel);

addons/knobs/src/react/index.js

@@ -7,9 +7,6 @@ import { knob, text, boolean, number, color, object, array, date, select, manage
 
 export { knob, text, boolean, number, color, object, array, date, select };
 
-/**
- * Handles a react story
- */
 export const reactHandler = (channel, knobStore) => getStory => context => {
   const initialContent = getStory(context);
   const props = { context, storyFn: getStory, channel, knobStore, initialContent };

addons/knobs/src/vue/index.js

@@ -42,9 +42,6 @@ export const vueHandler = (channel, knobStore) => getStory => context => ({
   },
 });
 
-// "Higher order component" / wrapper style API
-// In 3.3, this will become `withKnobs`, once our decorator API supports it.
-// See https://github.com/storybooks/storybook/pull/1527
 function wrapperKnobs(options) {
   const channel = addons.getChannel();
   manager.setChannel(channel);