# Please add meaningful plugin documentation, thank you **URL:** \ **Category:** Plugin builders\ **Created:** [September 2, 2019, 11:32am UTC](https://forum.bubble.io/t/please-add-meaningful-plugin-documentation-thank-you/65843 "2019-09-02T11:32:30Z")\ **Posts on this page:** 20\ **Page:** 1
**Author:** ![ava](https://sea1.discourse-cdn.com/bubble/user_avatar/forum.bubble.io/ava/32/12786_2.png) [@ava](https://forum.bubble.io/u/ava)\ **Post date:** [September 2, 2019, 11:32am UTC](https://forum.bubble.io/t/please-add-meaningful-plugin-documentation-thank-you/65843/1 "2019-09-02T11:32:30Z")
Hi all, This is an open letter to all the amazing and generous people who make Bubble plugins. I truly appreciate your effort and time in making Bubble plugins. You make Bubble better for everyone. However, I want to humbly provide some critical feedback: Bubble plugins are 95% impossible to use because the documentation is sparse, and often non-existent. I appreciate that many of you are making plugins for your own use, and just making them public because ‘why not’. However, if you’ve spent 5-25 hours making a plugin, by simply taking an extra 0.5-1 hours to write user-friendly documentation you can increase your impact on Bubble dramatically. It’s like you’ve run 95% of the race, and you just have to run the last 5%. Documentation is not super-easy to produce. Being user-friendly is a challenge, because you know your plugin inside and out, and putting yourself in the shoes of a new person will be hard. However, without doing so, you are condemning your beautiful plugin to the growing graveyard of Bubble plugins that no one will ever actually implement because there is no clear explanation of how it works. Thank you for considering writing complete user-friendly documentation for your plugins, Rob ---
**Author:** ![major\_groove](https://sea1.discourse-cdn.com/bubble/user_avatar/forum.bubble.io/major_groove/32/38989_2.png) [@major\_groove](https://forum.bubble.io/u/major_groove)\ **Post date:** [September 2, 2019, 11:43am UTC](https://forum.bubble.io/t/please-add-meaningful-plugin-documentation-thank-you/65843/2 "2019-09-02T11:43:56Z")
I just started to use my first plugin last night - Tagger - and one of my immediate thoughts was “wow, the documentation is sparse here”. I am having to piece it together from various forum posts and demos that I have found all over the place. Really this stuff needs “easy as falling off a log” documentation if they are to have a chance of going beyond the Bubble diehards. ---
**Author:** ![Nocodify](https://sea1.discourse-cdn.com/bubble/user_avatar/forum.bubble.io/nocodify/32/104659_2.png) [@Nocodify](https://forum.bubble.io/u/Nocodify)\ **Post date:** [September 2, 2019, 2:51pm UTC](https://forum.bubble.io/t/please-add-meaningful-plugin-documentation-thank-you/65843/3 "2019-09-02T14:51:01Z")
I agree with the tagger plugin. Really confused me and I ended up not using it ---
**Author:** ![nocodeventure](https://sea1.discourse-cdn.com/bubble/user_avatar/forum.bubble.io/nocodeventure/32/247164_2.png) [@nocodeventure](https://forum.bubble.io/u/nocodeventure)\ **Post date:** [September 2, 2019, 2:53pm UTC](https://forum.bubble.io/t/please-add-meaningful-plugin-documentation-thank-you/65843/4 "2019-09-02T14:53:53Z")
maybe @gaurav can respond to the above feedback ---
**Author:** ![Jici](https://sea1.discourse-cdn.com/bubble/user_avatar/forum.bubble.io/jici/32/30722_2.png) [@Jici](https://forum.bubble.io/u/Jici)\ **Post date:** [September 2, 2019, 4:05pm UTC](https://forum.bubble.io/t/please-add-meaningful-plugin-documentation-thank-you/65843/5 "2019-09-02T16:05:50Z")
I agree that some plugin should have better documentation. Actually I’m using the plugin documentation itself to add details on each fields and try to provide different demo that user can also use to better understand how the plugin work. Don’t hesitate to reach plugin creator to ask more information if needed. Most of the top plugins dev like @seanhoots @levon @gaurav provide good support and will help you do get thing done. ---
**Author:** ![AliFarahat](https://sea1.discourse-cdn.com/bubble/user_avatar/forum.bubble.io/alifarahat/32/189604_2.png) [@AliFarahat](https://forum.bubble.io/u/AliFarahat)\ **Post date:** [September 2, 2019, 4:27pm UTC](https://forum.bubble.io/t/please-add-meaningful-plugin-documentation-thank-you/65843/6 "2019-09-02T16:27:12Z")
I am definitely guilty of this. Will definitely schedule some time in to make this happen. Appreciate your letter ---
**Author:** ![gaurav](https://sea1.discourse-cdn.com/bubble/user_avatar/forum.bubble.io/gaurav/32/6666_2.png) [@gaurav](https://forum.bubble.io/u/gaurav)\ **Post date:** [September 2, 2019, 4:30pm UTC](https://forum.bubble.io/t/please-add-meaningful-plugin-documentation-thank-you/65843/7 "2019-09-02T16:30:37Z")
> [@major\_groove](#): > > I just started to use my first plugin last night - Tagger - and one of my immediate thoughts was “wow, the documentation is sparse here”. > [@Nocodify](#): > > I agree with the tagger plugin. Really confused me Could you elaborate on what was confusing… The documentation for it is sparse as it just does one / two simple things. The [instructions on the page](https://bubble.io/plugin/tagger-1507658968231x782106515828375600) lay these out as: ![image](https://us1.discourse-cdn.com/bubble/original/3X/1/c/1ce01975910a382b90fb57a6d75670c8c308c35b.png) ---
**Author:** ![major\_groove](https://sea1.discourse-cdn.com/bubble/user_avatar/forum.bubble.io/major_groove/32/38989_2.png) [@major\_groove](https://forum.bubble.io/u/major_groove)\ **Post date:** [September 3, 2019, 7:30pm UTC](https://forum.bubble.io/t/please-add-meaningful-plugin-documentation-thank-you/65843/8 "2019-09-03T19:30:00Z")
Honestly @gaurav, those first three lines barely mean anything. It’s difficult to know where to start as you are presumably so close to the topic that it is naturally completely unobvious to you what the problem is, and I am a Bubble relative newbie so it is partly my “fault” plus difficult for me to explain, but let me try. > Extract A one word instruction is a shaky start. I would say something like, “To install the element that will ‘Extract’ data from text:” > (i) Install the ‘extract’ element on the page I think you need to make clear that this just needs to go on the page. It doesn’t have to be doing anything - just be there. That had me stumped for ages. > (ii) The source data goes into the input on extractor I still don’t really know what this means. I guess you mean "The input for the Extractor element is \. > (iii) The extracted values are accessed as This Extractor’s emails, urls, hashtags, mentions etc. No idea what that means. Still trying to understand the above. > 1. Mentions Not even going there yet. Yours is I think the first non-Bubble Plugin I tried, so maybe this level of documentation is normal. It maybe makes more sense to experiences Bubble people (judging by the comments it does) but for newcomers it is too confusing. ---
**Author:** ![NigelG](https://avatars.discourse-cdn.com/v4/letter/n/ea5d25/32.png) [@NigelG](https://forum.bubble.io/u/NigelG)\ **Post date:** [September 3, 2019, 7:42pm UTC](https://forum.bubble.io/t/please-add-meaningful-plugin-documentation-thank-you/65843/9 "2019-09-03T19:42:07Z")
> [@major\_groove](#): > > It maybe makes more sense to experiences Bubble people (judging by the comments it does) but for newcomers it is too confusing. I am sorry to say this, but if you are having trouble with these instructions, then you are going to struggle with some non-plugin functions in bubble too. Learn the platform first, it will save you a lot of time in the long run. ---
**Author:** ![major\_groove](https://sea1.discourse-cdn.com/bubble/user_avatar/forum.bubble.io/major_groove/32/38989_2.png) [@major\_groove](https://forum.bubble.io/u/major_groove)\ **Post date:** [September 3, 2019, 7:58pm UTC](https://forum.bubble.io/t/please-add-meaningful-plugin-documentation-thank-you/65843/10 "2019-09-03T19:58:33Z")
Again, I would suggest that as someone very experienced in Bubble, it may be non-obvious to you how obscure those instructions are. I may be a beginner here, but having worked on lots of complicated projects before I have a pretty good feeling for when documentation is good or not (vs when I am just being thick!), regardless of whether I know the platform in-depth already or not. I’d say overall the Bubble documentation is on the weak side (so not just the plugins), and gives the impression of having been written by people who are in-depth to the platform, so again unaware of how it is to start afresh using Bubble. I’m assuming that is the sort of thing that will change now they have some VC money and can hire some technical writers. Maybe we can even assume I am the thicko exception here, but @Nocodify seems to run a service teaching or building nocode apps and he says he gave up, so it’s not just me. We need Bubble to be as widely successful as possible, and I would assume that the way to do that is to really broaden its appeal with “ELI5” instructions! 😄 ---
**Author:** ![major\_groove](https://sea1.discourse-cdn.com/bubble/user_avatar/forum.bubble.io/major_groove/32/38989_2.png) [@major\_groove](https://forum.bubble.io/u/major_groove)\ **Post date:** [September 3, 2019, 8:27pm UTC](https://forum.bubble.io/t/please-add-meaningful-plugin-documentation-thank-you/65843/11 "2019-09-03T20:27:55Z")
Just to expand a bit, I realised that the explanation on the [blogpage](http://forum.bubble.io/t/new-plugin-tagger/18909) about the plugin, is subtly slightly better than the plugin page itself. But the real standard for instructions for Tagger is this page: [https://buildingonbubble.com/block/tagger-plugin-for-mentions-1515412723033x963917052088942600](https://buildingonbubble.com/block/tagger-plugin-for-mentions-1515412723033x963917052088942600) which I see you wrote @NigelG, which is kinda ironic. 😜 Basically what you have written seems like good instructions with examples. Thanks! 😄 ---
**Author:** ![Nocodify](https://sea1.discourse-cdn.com/bubble/user_avatar/forum.bubble.io/nocodify/32/104659_2.png) [@Nocodify](https://forum.bubble.io/u/Nocodify)\ **Post date:** [September 3, 2019, 9:50pm UTC](https://forum.bubble.io/t/please-add-meaningful-plugin-documentation-thank-you/65843/12 "2019-09-03T21:50:56Z")
For me, the tagger plugin was a “nice to have feature.” If I really needed it, I would spend more time trying to figure it out. I couldn’t understand it the first go around, so I kind of gave up 😮 I’m sure I could figure it out if I spent more time on it. But I do agree with you that most plugins don’t have proper documentation. I also don’t suggest that plugin developers _must_ have documentation… it’s really up to them if they want to take the time to document. @gaurav is the man and I appreciate all he does for the Bubble community. ---
**Author:** ![cowontherun](https://sea1.discourse-cdn.com/bubble/user_avatar/forum.bubble.io/cowontherun/32/18211_2.png) [@cowontherun](https://forum.bubble.io/u/cowontherun)\ **Post date:** [September 3, 2019, 10:16pm UTC](https://forum.bubble.io/t/please-add-meaningful-plugin-documentation-thank-you/65843/13 "2019-09-03T22:16:28Z")
I don’t think that’s true Nigel, these instructions are confusing. ---
**Author:** ![cowontherun](https://sea1.discourse-cdn.com/bubble/user_avatar/forum.bubble.io/cowontherun/32/18211_2.png) [@cowontherun](https://forum.bubble.io/u/cowontherun)\ **Post date:** [September 3, 2019, 10:19pm UTC](https://forum.bubble.io/t/please-add-meaningful-plugin-documentation-thank-you/65843/14 "2019-09-03T22:19:46Z")
I completely agree these instructions are very confusing. There’s actually specific techniques and methodology for how to write support and training documentation, which any school teachers on here will be more than familiar with. Plugin builders can just google to read up on this, there are interesting tips. The end user is **never** to blame. ---
**Author:** ![StevenM](https://sea1.discourse-cdn.com/bubble/user_avatar/forum.bubble.io/stevenm/32/17066_2.png) [@StevenM](https://forum.bubble.io/u/StevenM)\ **Post date:** [September 3, 2019, 10:25pm UTC](https://forum.bubble.io/t/please-add-meaningful-plugin-documentation-thank-you/65843/15 "2019-09-03T22:25:02Z")
Yes I would completely agree they are confusing and not written for a non code user, but rather interpreted and written as a developer. I see this all the time and clearly if plugin builders can’t see that their instructions are either non existent or confusing then you need to take a look at some of the benchmark help documentation and get some one else with the required expertise to write it for you. ---
**Author:** ![StevenM](https://sea1.discourse-cdn.com/bubble/user_avatar/forum.bubble.io/stevenm/32/17066_2.png) [@StevenM](https://forum.bubble.io/u/StevenM)\ **Post date:** [September 3, 2019, 10:30pm UTC](https://forum.bubble.io/t/please-add-meaningful-plugin-documentation-thank-you/65843/16 "2019-09-03T22:30:52Z")
For those who still don’t get it. Some good advice here: > **[How to Explain Technical Information to Non-Techies](https://www.quickbase.com/blog/how-to-explain-technical-information-to-non-techies)** > > If you’re asked to explain technical information to a non-technical audience, here’s what you need to do. > **[Writing Technically To The Non-Technical Audience](https://blog.csoftintl.com/writing-technically-non-technical-audience/)** > > Producing technical documentation in the wrong way can cost a company. Here are some tips to keep in mind as a technical writer. [https://geekboss.com/write-for-a-non-technical-audience/](https://geekboss.com/write-for-a-non-technical-audience/) ---
**Author:** ![Jici](https://sea1.discourse-cdn.com/bubble/user_avatar/forum.bubble.io/jici/32/30722_2.png) [@Jici](https://forum.bubble.io/u/Jici)\ **Post date:** [September 3, 2019, 11:28pm UTC](https://forum.bubble.io/t/please-add-meaningful-plugin-documentation-thank-you/65843/17 "2019-09-03T23:28:34Z")
> [@cowontherun](#): > > The end user is **never** to blame. Almost. I think that end user must also do is part to learn the familliar word used in the domain they are. I will not use something else than “Add element on the page” or “Add a workflow” because this is a basic thing of Bubble world. If user don’t know what is an element or a workflow… I think he need to get familiar with Bubble a little bit more before. I also understand dev that create plugin and make it available for free to not make extensive documentation. However. A minimal instruction to make the plugin usable should be available. For me “Install the ‘extract’ element on the page” is correct. But ‘The extracted values are accessed as This Extractor’s emails, urls, hashtags, mentions etc.’ may miss a more specific thing like You can access email, url, hastags or mentions in the element state (element state for me is something that end user need to learn to use bubble and plugin). Nocode doesn’t mean nothing to learn… just no code to learn (and write, and understand…) 😜 Bubble user need to learn Bubble first. ---
**Author:** ![sudsy](https://sea1.discourse-cdn.com/bubble/user_avatar/forum.bubble.io/sudsy/32/114637_2.png) [@sudsy](https://forum.bubble.io/u/sudsy)\ **Post date:** [September 4, 2019, 12:23am UTC](https://forum.bubble.io/t/please-add-meaningful-plugin-documentation-thank-you/65843/18 "2019-09-04T00:23:45Z")
This thread prompted me to create a poll. I welcome your participation. Thank you! > [@Please Take the Plug-In User Poll](http://forum.bubble.io/t/please-take-the-plug-in-user-poll/65961): > > Hi all, [This recent post](http://forum.bubble.io/t/please-add-meaningful-plugin-documentation-thank-you/65843) prompted me to try the polling feature of the forum. (I hope this is the proper category for it.) As a developer who has released a plugin with both extensive documentation and demos (and who knows how time consuming that can be) and who also plans to release more plugins, I’d like to get a sense for what users find most useful - i.e. docs or working example. This is purely hypothetical, as I suspect the ideal answer is some combination thereof, but it would be helpful… ---
**Author:** ![cowontherun](https://sea1.discourse-cdn.com/bubble/user_avatar/forum.bubble.io/cowontherun/32/18211_2.png) [@cowontherun](https://forum.bubble.io/u/cowontherun)\ **Post date:** [September 4, 2019, 2:48am UTC](https://forum.bubble.io/t/please-add-meaningful-plugin-documentation-thank-you/65843/19 "2019-09-04T02:48:48Z")
It’s the height of arrogance for a developer to argue over whether an instruction is confusing or not when given feedback that it is confusing. If the plugin only does ‘1 or 2’ things, then it won’t take long to humbly update the docs to make it understandable without needing to make any fuss about it. I’ve worked with Bubble for nearly 3 years and am an ex-front end web developer. The instructions make no sense. ---
**Author:** ![Jici](https://sea1.discourse-cdn.com/bubble/user_avatar/forum.bubble.io/jici/32/30722_2.png) [@Jici](https://forum.bubble.io/u/Jici)\ **Post date:** [September 4, 2019, 3:02am UTC](https://forum.bubble.io/t/please-add-meaningful-plugin-documentation-thank-you/65843/20 "2019-09-04T03:02:11Z")
@cowontherun Like I said in my post, I didn’t say it’s perfect. And give an example that for me is correct and what i found is not (personnaly). also, for what I know, @gaurav ask to get more explanation of what is confusing for you (and other) (I believe to update it). This is how I understand this reply. [Next page](https://forum.bubble.io/t/please-add-meaningful-plugin-documentation-thank-you/65843.md?page=2)