maildev@lists.thunderbird.net

Thunderbird email developers

View all threads

Updating extensions for Thunderbird 68 - new documentation

GL
Geoff Lankow
Fri, Mar 1, 2019 2:21 AM

Not long ago I wrote a new piece on updating extensions. It's
essentially a longer version of the wiki page
https://wiki.mozilla.org/Thunderbird/Add-ons_Guide_63 on the same subject.

For want of a better place, I've put it on the APIs site:
https://thunderbird-webextensions.readthedocs.io/en/latest/how-to/extensions68.html.
(If you'd like to add something, send a pull request on the GitHub repo,
this page is at
https://github.com/thundernest/webext-docs/blob/master/how-to/extensions68.rst.)

Please take note of the second paragraph – this isn't an exhaustive list
of everything you might need to do to your extension, that would be
impossible.

Hope that it helps!

GL

Not long ago I wrote a new piece on updating extensions. It's essentially a longer version of the wiki page <https://wiki.mozilla.org/Thunderbird/Add-ons_Guide_63> on the same subject. For want of a better place, I've put it on the APIs site: https://thunderbird-webextensions.readthedocs.io/en/latest/how-to/extensions68.html. (If you'd like to add something, send a pull request on the GitHub repo, this page is at https://github.com/thundernest/webext-docs/blob/master/how-to/extensions68.rst.) Please take note of the second paragraph – this isn't an exhaustive list of everything you might need to do to your extension, that would be impossible. Hope that it helps! GL
BB
Ben Bucksch
Fri, Mar 1, 2019 5:33 AM

hey Geoff,

this is great! toss us a nice start and will hopefully clear up some of the confusion we had recently. it's even digestible by power users. but still precise enough for devs to clearly knew what to do. very good writing!

of course, this is just a start. we should have more sections for migrating specific issues, e.g. how to use the overlay loader, what differences exist between XUL widget bindings and HTML widget events etc..

it would also be helpful to link to the webextension APIs. unless we do already and i missed the link.

Ben

Am 1. März 2019 03:21:54 MEZ schrieb Geoff Lankow geoff@thunderbird.net:

Not long ago I wrote a new piece on updating extensions. It's
essentially a longer version of the wiki page
https://wiki.mozilla.org/Thunderbird/Add-ons_Guide_63 on the same
subject.

For want of a better place, I've put it on the APIs site:
https://thunderbird-webextensions.readthedocs.io/en/latest/how-to/extensions68.html.

(If you'd like to add something, send a pull request on the GitHub
repo,
this page is at
https://github.com/thundernest/webext-docs/blob/master/how-to/extensions68.rst.)

Please take note of the second paragraph – this isn't an exhaustive
list
of everything you might need to do to your extension, that would be
impossible.

Hope that it helps!

GL

--
Sent from my phone. Please excuse the brevity.

hey Geoff, this is great! toss us a nice start and will hopefully clear up some of the confusion we had recently. it's even digestible by power users. but still precise enough for devs to clearly knew what to do. very good writing! of course, this is just a start. we should have more sections for migrating specific issues, e.g. how to use the overlay loader, what differences exist between XUL widget bindings and HTML widget events etc.. it would also be helpful to link to the webextension APIs. unless we do already and i missed the link. Ben Am 1. März 2019 03:21:54 MEZ schrieb Geoff Lankow <geoff@thunderbird.net>: >Not long ago I wrote a new piece on updating extensions. It's >essentially a longer version of the wiki page ><https://wiki.mozilla.org/Thunderbird/Add-ons_Guide_63> on the same >subject. > >For want of a better place, I've put it on the APIs site: >https://thunderbird-webextensions.readthedocs.io/en/latest/how-to/extensions68.html. > >(If you'd like to add something, send a pull request on the GitHub >repo, >this page is at >https://github.com/thundernest/webext-docs/blob/master/how-to/extensions68.rst.) > >Please take note of the second paragraph – this isn't an exhaustive >list >of everything you might need to do to your extension, that would be >impossible. > >Hope that it helps! > >GL -- Sent from my phone. Please excuse the brevity.
JB
John Bieling
Fri, Mar 1, 2019 7:39 AM

We should declare one of the two resources as "standard".

I just started to add migration hints to the addon 63 guide which are of
course missing in your guide now. Doing double work on the documentation
is a waste of time.

Yours looks nicer. Shall we declare your document as standard and move
everything missing from the addon 63 guide into that and lock the addon
63 guide?

John

On 01.03.2019 06:33, Ben Bucksch wrote:

hey Geoff,

this is great! toss us a nice start and will hopefully clear up some
of the confusion we had recently. it's even digestible by power users.
but still precise enough for devs to clearly knew what to do. very
good writing!

of course, this is just a start. we should have more sections for
migrating specific issues, e.g. how to use the overlay loader, what
differences exist between XUL widget bindings and HTML widget events etc..

it would also be helpful to link to the webextension APIs. unless we
do already and i missed the link.

Ben

Am 1. März 2019 03:21:54 MEZ schrieb Geoff Lankow
geoff@thunderbird.net:

 Not long ago I wrote a new piece on updating extensions. It's
 essentially a longer version of the wiki page
 <https://wiki.mozilla.org/Thunderbird/Add-ons_Guide_63> on the
 same subject.

 For want of a better place, I've put it on the APIs site:
 https://thunderbird-webextensions.readthedocs.io/en/latest/how-to/extensions68.html.
 (If you'd like to add something, send a pull request on the GitHub
 repo, this page is at
 https://github.com/thundernest/webext-docs/blob/master/how-to/extensions68.rst.)

 Please take note of the second paragraph – this isn't an
 exhaustive list of everything you might need to do to your
 extension, that would be impossible.

 Hope that it helps!

 GL

--
Sent from my phone. Please excuse the brevity.


Maildev mailing list
Maildev@lists.thunderbird.net
http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net

We should declare one of the two resources as "standard". I just started to add migration hints to the addon 63 guide which are of course missing in your guide now. Doing double work on the documentation is a waste of time. Yours looks nicer. Shall we declare your document as standard and move everything missing from the addon 63 guide into that and lock the addon 63 guide? John On 01.03.2019 06:33, Ben Bucksch wrote: > hey Geoff, > > this is great! toss us a nice start and will hopefully clear up some > of the confusion we had recently. it's even digestible by power users. > but still precise enough for devs to clearly knew what to do. very > good writing! > > of course, this is just a start. we should have more sections for > migrating specific issues, e.g. how to use the overlay loader, what > differences exist between XUL widget bindings and HTML widget events etc.. > > it would also be helpful to link to the webextension APIs. unless we > do already and i missed the link. > > Ben > > Am 1. März 2019 03:21:54 MEZ schrieb Geoff Lankow > <geoff@thunderbird.net>: > > Not long ago I wrote a new piece on updating extensions. It's > essentially a longer version of the wiki page > <https://wiki.mozilla.org/Thunderbird/Add-ons_Guide_63> on the > same subject. > > For want of a better place, I've put it on the APIs site: > https://thunderbird-webextensions.readthedocs.io/en/latest/how-to/extensions68.html. > (If you'd like to add something, send a pull request on the GitHub > repo, this page is at > https://github.com/thundernest/webext-docs/blob/master/how-to/extensions68.rst.) > > Please take note of the second paragraph – this isn't an > exhaustive list of everything you might need to do to your > extension, that would be impossible. > > Hope that it helps! > > GL > > > -- > Sent from my phone. Please excuse the brevity. > > _______________________________________________ > Maildev mailing list > Maildev@lists.thunderbird.net > http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net
MM
Magnus Melin
Fri, Mar 1, 2019 7:59 AM

On 01-03-2019 09:39, John Bieling wrote:

Yours looks nicer. Shall we declare your document as standard and move
everything missing from the addon 63 guide into that and lock the
addon 63 guide?

Agreed, nice work Geoff!

I went ahead and added a note on top of the old wiki page urging people
to go to
https://thunderbird-webextensions.readthedocs.io/en/latest/how-to/extensions68.html
instead.

 -Magnus

On 01-03-2019 09:39, John Bieling wrote: > Yours looks nicer. Shall we declare your document as standard and move > everything missing from the addon 63 guide into that and lock the > addon 63 guide? Agreed, nice work Geoff! I went ahead and added a note on top of the old wiki page urging people to go to https://thunderbird-webextensions.readthedocs.io/en/latest/how-to/extensions68.html instead.  -Magnus
RS
Ryan Sipes
Fri, Mar 1, 2019 2:46 PM

Yes, this is awesome Geoff.

We could look at pointing to this documentation for add-ons developers
from the website as well (I might set that up now on the "Get Involved"
page). It would be great if there was another section called "Getting
Started" for those who are taking a first shot at this.

Last bit here, I'll look into getting a custom domain to point at this,
like mailext.thunderbird.net - if anyone has better ideas, let me know.

Ryan Sipes
Community Manager
Thunderbird

On 3/1/19 12:59 AM, Magnus Melin wrote:

On 01-03-2019 09:39, John Bieling wrote:

Yours looks nicer. Shall we declare your document as standard and
move everything missing from the addon 63 guide into that and lock
the addon 63 guide?

Agreed, nice work Geoff!

I went ahead and added a note on top of the old wiki page urging
people to go to
https://thunderbird-webextensions.readthedocs.io/en/latest/how-to/extensions68.html
instead.

 -Magnus


Maildev mailing list
Maildev@lists.thunderbird.net
http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net

Yes, this is awesome Geoff. We could look at pointing to this documentation for add-ons developers from the website as well (I might set that up now on the "Get Involved" page). It would be great if there was another section called "Getting Started" for those who are taking a first shot at this. Last bit here, I'll look into getting a custom domain to point at this, like mailext.thunderbird.net - if anyone has better ideas, let me know. Ryan Sipes Community Manager Thunderbird On 3/1/19 12:59 AM, Magnus Melin wrote: > On 01-03-2019 09:39, John Bieling wrote: >> Yours looks nicer. Shall we declare your document as standard and >> move everything missing from the addon 63 guide into that and lock >> the addon 63 guide? > > Agreed, nice work Geoff! > > I went ahead and added a note on top of the old wiki page urging > people to go to > https://thunderbird-webextensions.readthedocs.io/en/latest/how-to/extensions68.html > instead. > >  -Magnus > > > _______________________________________________ > Maildev mailing list > Maildev@lists.thunderbird.net > http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >
MM
Magnus Melin
Fri, Mar 1, 2019 4:50 PM

On 01-03-2019 16:46, Ryan Sipes wrote:

Last bit here, I'll look into getting a custom domain to point at this,
like mailext.thunderbird.net - if anyone has better ideas, let me know.

developer(s).thunderbird.net? As a start page for all relevant developer
documentation.

 -Magnus

On 01-03-2019 16:46, Ryan Sipes wrote: > Last bit here, I'll look into getting a custom domain to point at this, > like mailext.thunderbird.net - if anyone has better ideas, let me know. developer(s).thunderbird.net? As a start page for all relevant developer documentation.  -Magnus
RS
Ryan Sipes
Fri, Mar 1, 2019 5:01 PM

Yeah, I much prefer using developer.thunderbird.net - but then we'd want
to ensure we had documentation for both core development and add-on
development.

As a reference, I very much like how elementary OS' developer page
https://developer.elementary.io/ looks and feels.

Ryan Sipes
Community Manager
Thunderbird

On 3/1/19 9:50 AM, Magnus Melin wrote:

On 01-03-2019 16:46, Ryan Sipes wrote:

Last bit here, I'll look into getting a custom domain to point at this,
like mailext.thunderbird.net - if anyone has better ideas, let me know.

developer(s).thunderbird.net? As a start page for all relevant
developer documentation.

 -Magnus


Maildev mailing list
Maildev@lists.thunderbird.net
http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net

Yeah, I much prefer using developer.thunderbird.net - but then we'd want to ensure we had documentation for both core development and add-on development. As a reference, I very much like how elementary OS' developer page <https://developer.elementary.io/> looks and feels. Ryan Sipes Community Manager Thunderbird On 3/1/19 9:50 AM, Magnus Melin wrote: > On 01-03-2019 16:46, Ryan Sipes wrote: >> Last bit here, I'll look into getting a custom domain to point at this, >> like mailext.thunderbird.net - if anyone has better ideas, let me know. > > developer(s).thunderbird.net? As a start page for all relevant > developer documentation. > >  -Magnus > > > > _______________________________________________ > Maildev mailing list > Maildev@lists.thunderbird.net > http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >