Sorry to revert your edits without discussing them first. I only saw this post after I’d already seen the edits. I already talked to you about this in a PM, but: I do appreciate your efforts to improve the docs. I reverted the changes mostly for a couple of reasons:
I want that page to function mainly as an index of links into the docs. I think starting it off with a wall of text makes it function less well as an index.
I want the WebExtensions docs to be browser-agnostic as far as possible: I want Edge developers to be relatively comfortable visiting these pages, and I don’t want them to have to disentangle what’s Firefox-specific from what works in Edge. A lot of the content you added was Firefox-specific, and I think would be quite alienating for people targeting other browsers.
About the problem you identify:
A lot of people ask a lot of trivial questions both here and on reddit related to WebExtensions.
To be honest, I think some people read the docs to find the answers, and some go straight to asking trivial questions, and there’s not much we can do to change this. For example: “Some don’t know…how to debug them” - well, there’s a link in that main page called “Debugging”, that tells you how to do this. If you load the main page, type ctrl+F, type “debug”: you’ll find it. If someone can’t do that I’d really question whether they would read your text, find the about:debugging link, follow that link, then read that page to find the link to the same “Debugging” page that’s already linked from the main page.