Why is getting started SUCH a chaotic mess?

I just looked up how to code a Firefox add-on for the very first time,
and the first thing one ends up with after a web search is this utterly useless page:

(After coming from Entwickler-Zentrum :: Add-ons für Firefox which is amazing at hiding a big button at the top in plain sight.)

It is useless primarily because it is not linear, but has countless links; none of which pointing at a “start here” point. And secondarily because instead it focuses on being 99% fluff and self-adulation and style over substance, like it was Apple.

Trying several links that seem like the best hope of getting to anything useful, again, only leads to pages with “side dishes”, like this one linked from “Learn”:

Which, one would expect to finally teach one how to set up an extension and what file to edit and what page to open for references. As you may notice, it does everything BUT that.
But hey, at least I know about the MDN, and it being probably the reference source. Unfortunately, that is the bit I already knew.

But I’m still looking for the GUIDE. Like a HOWTO. A workflow!
So since “Learn” is a useless waste of time, I go back and click on “Develop”.

Which tells me I need a text editor and Firefox. Wow! I never new that! I never new that! /s
Further down where I expect the meat to finally be, I just find nonsense like the Americanism of an “ZOMG eXpErIeNcE”… This is not a Sillly CON Valley drug party! Where’s the meat?!? (Notice how I’m already getting angry at this point? Because this is the point where it has gotten too ridiculous, and if I wanted that, I’d watch another news bit on current US politics. XD)

The core problem is the lack of linearity. There are tons of links and not even one of them actually get you to a true guide on how to get started from scratch (on a single page, with only “next” being allowed as a link).
You might say that it is nice to have choices, but you expect people who by definition don’t have a clue about the topic to make choices on it. Especially topics hidden behind links that on top of it don’t even have the meaning one expects.

I hope you can follow that this is probably not the user eXpErIeNcE​:trade_mark: you want to give new potential supporters (all three of them), unless the malicious gossip that Mozilla is just a Google monopolism-repelling alibi and for that reason intentionally as bad as physically possible without losing believability. :wink:

For now, I’ve dumped my efforts again, as Mozilla yet again has utterly crushed the delicate little plant that had just sprouted.
I will rather die that even touch Google Internet Explorer 2: Psychopathic Boogaloo (Chrome) with a rusty ten foot acid-glass-shard-covered Mad Max steel furnace weapon. So I willl have to wait for Ladybird to steamroll the web back to sanity, and keep on developing Plan 11.

But for the next time I think I could write an adapter for legacy technology (HTML5, browsers) for it, maybe, just maybe, could you, pretty please, make sure there is one single clear and linear chain of linked pages that describe how to, in a nutshell, create a minimum viable web extension with a single simple functionality? (Say doing something to the currently viewed page. … In my case, I wanted to add a 11fs panel to the bottom that shows the object for the currently shown web page. Where 11fs is the Plan 11 successor to file systems, and Plan 11 is a project of mine that I do not want to reveal yet. [And is not related to anything else with that name that might be online.])

I recently made my first extension with the help of this resource:

I understand your frustration, but I encourage you to give it another shot. :slightly_smiling_face:

2 Likes

It pains me to say this, but these days, it’s quite handy to ask ChatGPT or any other modern chatbot for help, especially when when starting a new project.
It will tell you exactly what to do, what files to use, and you can ask further questions.

Also, don’t forget to check MDN for useful docs:

Hey @njz. Sorry about the poor getting started experience and thanks for the feedback. Candidly, I’m also not wild about extensionworkshop.com right now: the name implies it’s a workshop or tutorial but most of it’s content is about Firefox specific extension development considerations, information is too spread out across the site, it’s hard to navigate between related pages, etc.

Thanks for sharing those links, @Spooce and @juraj.masiar. I hesitate to mention the webextensions-examples repo; while it has some useful reference material, it has … uh … “grown organically” over the years (read: it’s a mess). Finally, if you have questions or want to talk through an issue, folks around here also pretty friendly :smile:

1 Like