Hi, I just saw, that someone added new information to https://wiki.mozilla.org/Thunderbird/Add-ons_Guide_63 But that guide was declared obsolete. The added information are great and helpful but I strongly suggest to add them to the new guide. The new guide is linked directly under https://developer.thunderbird.net as "Updating Extensions for 68" where you can fork it on github and send a pull request. I did the same! While updating my AddOn CategoryManager to TB68, I found all sorts of stuff not working and added everything I found to the new guide. If we need a larger review community for the guide repo, than that is something Geoff and Ryan need to discuss I think. In these times that would be a great help, so we can get the new information out fast. Your thoughts? Best regards, John

Good. Things are working as intended. The page I wrote was /not/ intended to be a definitive guide to everything that has changed. It even says so in the introduction. Such information is much better suited to the wiki. GL On 1/04/19 22:59, John Bieling wrote: > Hi, > > I just saw, that someone added new information to > > https://wiki.mozilla.org/Thunderbird/Add-ons_Guide_63 > > But that guide was declared obsolete. The added information are great > and helpful but I strongly suggest to add them to the new guide. The new > guide is linked directly under > > https://developer.thunderbird.net > > as "Updating Extensions for 68" where you can fork it on github and send > a pull request. > > > > I did the same! While updating my AddOn CategoryManager to TB68, I found > all sorts of stuff not working and added everything I found to the new > guide. > > If we need a larger review community for the guide repo, than that is > something Geoff and Ryan need to discuss I think. In these times that > would be a great help, so we can get the new information out fast. > > > Your thoughts? > > Best regards, > John > > _______________________________________________ > Maildev mailing list > Maildev@lists.thunderbird.net > http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >

From the last mail exchange regarding this new guide, I would have expected a different answer. Thanks for the clarification. John On 01.04.2019 12:11, Geoff Lankow wrote: > > Good. Things are working as intended. > > The page I wrote was /not/ intended to be a definitive guide to > everything that has changed. It even says so in the introduction. Such > information is much better suited to the wiki. > > GL > > On 1/04/19 22:59, John Bieling wrote: >> Hi, >> >> I just saw, that someone added new information to >> >> https://wiki.mozilla.org/Thunderbird/Add-ons_Guide_63 >> >> But that guide was declared obsolete. The added information are great >> and helpful but I strongly suggest to add them to the new guide. The new >> guide is linked directly under >> >> https://developer.thunderbird.net >> >> as "Updating Extensions for 68" where you can fork it on github and send >> a pull request. >> >> >> >> I did the same! While updating my AddOn CategoryManager to TB68, I found >> all sorts of stuff not working and added everything I found to the new >> guide. >> >> If we need a larger review community for the guide repo, than that is >> something Geoff and Ryan need to discuss I think. In these times that >> would be a great help, so we can get the new information out fast. >> >> >> Your thoughts? >> >> Best regards, >> John >> >> _______________________________________________ >> Maildev mailing list >> Maildev@lists.thunderbird.net >> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >> > > _______________________________________________ > Maildev mailing list > Maildev@lists.thunderbird.net > http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net

Or, you are welcome to send a pull request to the developer.thunderbird.net docs - and we can start to create better documentation there for updating add-ons. The idea with the new developer docs is to consolidate as much documentation that is helpful to developers in one place. Ryan Sipes Community and Business Development Manager Thunderbird <https://thunderbird.net> On 4/1/19 4:44 AM, John Bieling wrote: > From the last mail exchange regarding this new guide, I would have > expected a different answer. Thanks for the clarification. > > John > > > > On 01.04.2019 12:11, Geoff Lankow wrote: >> >> Good. Things are working as intended. >> >> The page I wrote was /not/ intended to be a definitive guide to >> everything that has changed. It even says so in the introduction. >> Such information is much better suited to the wiki. >> >> GL >> >> On 1/04/19 22:59, John Bieling wrote: >>> Hi, >>> >>> I just saw, that someone added new information to >>> >>> https://wiki.mozilla.org/Thunderbird/Add-ons_Guide_63 >>> >>> But that guide was declared obsolete. The added information are great >>> and helpful but I strongly suggest to add them to the new guide. The >>> new >>> guide is linked directly under >>> >>> https://developer.thunderbird.net >>> >>> as "Updating Extensions for 68" where you can fork it on github and >>> send >>> a pull request. >>> >>> >>> >>> I did the same! While updating my AddOn CategoryManager to TB68, I >>> found >>> all sorts of stuff not working and added everything I found to the new >>> guide. >>> >>> If we need a larger review community for the guide repo, than that is >>> something Geoff and Ryan need to discuss I think. In these times that >>> would be a great help, so we can get the new information out fast. >>> >>> >>> Your thoughts? >>> >>> Best regards, >>> John >>> >>> _______________________________________________ >>> Maildev mailing list >>> Maildev@lists.thunderbird.net >>> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >>> >> >> _______________________________________________ >> Maildev mailing list >> Maildev@lists.thunderbird.net >> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net > > > _______________________________________________ > Maildev mailing list > Maildev@lists.thunderbird.net > http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net

> The idea with the new developer docs is to consolidate as much > documentation that is helpful to developers in one place. > That was my impression and that is why I proposed to do pull requests, but Geoffs answer kinda contradicts that, as he wants to have the details on the wiki. Why does Geoff object to have all the info we gathered available on the main guide? It will never contain info about ALL the changes (because probably nobody knows all of them), but it should contain all we DO know about. Why spread it among two different resources? I am pretty lost with the current situation, as I thought Geoff introduced the new guide as a replacement with a common the look and feel for developer.thunderbird.net. John > Ryan Sipes > Community and Business Development Manager > Thunderbird <https://thunderbird.net> > > On 4/1/19 4:44 AM, John Bieling wrote: >> From the last mail exchange regarding this new guide, I would have >> expected a different answer. Thanks for the clarification. >> >> John >> >> >> >> On 01.04.2019 12:11, Geoff Lankow wrote: >>> >>> Good. Things are working as intended. >>> >>> The page I wrote was /not/ intended to be a definitive guide to >>> everything that has changed. It even says so in the introduction. >>> Such information is much better suited to the wiki. >>> >>> GL >>> >>> On 1/04/19 22:59, John Bieling wrote: >>>> Hi, >>>> >>>> I just saw, that someone added new information to >>>> >>>> https://wiki.mozilla.org/Thunderbird/Add-ons_Guide_63 >>>> >>>> But that guide was declared obsolete. The added information are great >>>> and helpful but I strongly suggest to add them to the new guide. >>>> The new >>>> guide is linked directly under >>>> >>>> https://developer.thunderbird.net >>>> >>>> as "Updating Extensions for 68" where you can fork it on github and >>>> send >>>> a pull request. >>>> >>>> >>>> >>>> I did the same! While updating my AddOn CategoryManager to TB68, I >>>> found >>>> all sorts of stuff not working and added everything I found to the new >>>> guide. >>>> >>>> If we need a larger review community for the guide repo, than that is >>>> something Geoff and Ryan need to discuss I think. In these times that >>>> would be a great help, so we can get the new information out fast. >>>> >>>> >>>> Your thoughts? >>>> >>>> Best regards, >>>> John >>>> >>>> _______________________________________________ >>>> Maildev mailing list >>>> Maildev@lists.thunderbird.net >>>> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >>>> >>> >>> _______________________________________________ >>> Maildev mailing list >>> Maildev@lists.thunderbird.net >>> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >> >> >> _______________________________________________ >> Maildev mailing list >> Maildev@lists.thunderbird.net >> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net > > _______________________________________________ > Maildev mailing list > Maildev@lists.thunderbird.net > http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net

I'll let Geoff speak for himself, but from what I understand he was just saying that the stuff on the Wiki is more up-to-date than his documentation on RTDs. Really, this opens up a new conversation which is where is the best place to provide resources to add-ons developers. I just recently spun up developer.thunderbird.net and very soon I will start twisting arms to ensure everything that needs to be there is there. But since this other stuff is so new, not everyone contributing to Thunderbird is ensuring they are up-to-date. So they are not yet a reliable source of information. Ryan Sipes Community and Business Development Manager Thunderbird <https://thunderbird.net> On 4/1/19 12:35 PM, John Bieling wrote: > > >> The idea with the new developer docs is to consolidate as much >> documentation that is helpful to developers in one place. >> > That was my impression and that is why I proposed to do pull requests, > but Geoffs answer kinda contradicts that, as he wants to have the > details on the wiki. > > Why does Geoff object to have all the info we gathered available on > the main guide? It will never contain info about ALL the changes > (because probably nobody knows all of them), but it should contain all > we DO know about. Why spread it among two different resources? > > I am pretty lost with the current situation, as I thought Geoff > introduced the new guide as a replacement with a common the look and > feel for developer.thunderbird.net. > > > John > > > >> Ryan Sipes >> Community and Business Development Manager >> Thunderbird <https://thunderbird.net> >> >> On 4/1/19 4:44 AM, John Bieling wrote: >>> From the last mail exchange regarding this new guide, I would have >>> expected a different answer. Thanks for the clarification. >>> >>> John >>> >>> >>> >>> On 01.04.2019 12:11, Geoff Lankow wrote: >>>> >>>> Good. Things are working as intended. >>>> >>>> The page I wrote was /not/ intended to be a definitive guide to >>>> everything that has changed. It even says so in the introduction. >>>> Such information is much better suited to the wiki. >>>> >>>> GL >>>> >>>> On 1/04/19 22:59, John Bieling wrote: >>>>> Hi, >>>>> >>>>> I just saw, that someone added new information to >>>>> >>>>> https://wiki.mozilla.org/Thunderbird/Add-ons_Guide_63 >>>>> >>>>> But that guide was declared obsolete. The added information are great >>>>> and helpful but I strongly suggest to add them to the new guide. >>>>> The new >>>>> guide is linked directly under >>>>> >>>>> https://developer.thunderbird.net >>>>> >>>>> as "Updating Extensions for 68" where you can fork it on github >>>>> and send >>>>> a pull request. >>>>> >>>>> >>>>> >>>>> I did the same! While updating my AddOn CategoryManager to TB68, I >>>>> found >>>>> all sorts of stuff not working and added everything I found to the >>>>> new >>>>> guide. >>>>> >>>>> If we need a larger review community for the guide repo, than that is >>>>> something Geoff and Ryan need to discuss I think. In these times that >>>>> would be a great help, so we can get the new information out fast. >>>>> >>>>> >>>>> Your thoughts? >>>>> >>>>> Best regards, >>>>> John >>>>> >>>>> _______________________________________________ >>>>> Maildev mailing list >>>>> Maildev@lists.thunderbird.net >>>>> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >>>>> >>>> >>>> _______________________________________________ >>>> Maildev mailing list >>>> Maildev@lists.thunderbird.net >>>> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >>> >>> >>> _______________________________________________ >>> Maildev mailing list >>> Maildev@lists.thunderbird.net >>> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >> >> _______________________________________________ >> Maildev mailing list >> Maildev@lists.thunderbird.net >> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net > > > _______________________________________________ > Maildev mailing list > Maildev@lists.thunderbird.net > http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net

The article I wrote on RTD was not intended to to contain every minute detail. Others decided that it should be, which I just don't agree with, although I didn't complain at the time. A wiki (not necessarily the one we currently have) is much better suited as 1. anyone with an account can edit it. 2. changes happen immediately and don't need anyone else's input. 3. headings and bullet points is better for listing the information than prose. I should've posted what I wrote on my blog and then there would be no argument over what should or shouldn't be the content of it. As it happens I never thought that RTD was the right place and I have been meaning to get it copied on to developer.thunderbird.net. GL On 2/04/19 08:13, Ryan Sipes wrote: > > I'll let Geoff speak for himself, but from what I understand he was > just saying that the stuff on the Wiki is more up-to-date than his > documentation on RTDs. Really, this opens up a new conversation which > is where is the best place to provide resources to add-ons developers. > I just recently spun up developer.thunderbird.net and very soon I will > start twisting arms to ensure everything that needs to be there is there. > > But since this other stuff is so new, not everyone contributing to > Thunderbird is ensuring they are up-to-date. So they are not yet a > reliable source of information. > > Ryan Sipes > Community and Business Development Manager > Thunderbird <https://thunderbird.net> > > On 4/1/19 12:35 PM, John Bieling wrote: >> >> >>> The idea with the new developer docs is to consolidate as much >>> documentation that is helpful to developers in one place. >>> >> That was my impression and that is why I proposed to do pull >> requests, but Geoffs answer kinda contradicts that, as he wants to >> have the details on the wiki. >> >> Why does Geoff object to have all the info we gathered available on >> the main guide? It will never contain info about ALL the changes >> (because probably nobody knows all of them), but it should contain >> all we DO know about. Why spread it among two different resources? >> >> I am pretty lost with the current situation, as I thought Geoff >> introduced the new guide as a replacement with a common the look and >> feel for developer.thunderbird.net. >> >> >> John >> >> >> >>> Ryan Sipes >>> Community and Business Development Manager >>> Thunderbird <https://thunderbird.net> >>> >>> On 4/1/19 4:44 AM, John Bieling wrote: >>>> From the last mail exchange regarding this new guide, I would have >>>> expected a different answer. Thanks for the clarification. >>>> >>>> John >>>> >>>> >>>> >>>> On 01.04.2019 12:11, Geoff Lankow wrote: >>>>> >>>>> Good. Things are working as intended. >>>>> >>>>> The page I wrote was /not/ intended to be a definitive guide to >>>>> everything that has changed. It even says so in the introduction. >>>>> Such information is much better suited to the wiki. >>>>> >>>>> GL >>>>> >>>>> On 1/04/19 22:59, John Bieling wrote: >>>>>> Hi, >>>>>> >>>>>> I just saw, that someone added new information to >>>>>> >>>>>> https://wiki.mozilla.org/Thunderbird/Add-ons_Guide_63 >>>>>> >>>>>> But that guide was declared obsolete. The added information are >>>>>> great >>>>>> and helpful but I strongly suggest to add them to the new guide. >>>>>> The new >>>>>> guide is linked directly under >>>>>> >>>>>> https://developer.thunderbird.net >>>>>> >>>>>> as "Updating Extensions for 68" where you can fork it on github >>>>>> and send >>>>>> a pull request. >>>>>> >>>>>> >>>>>> >>>>>> I did the same! While updating my AddOn CategoryManager to TB68, >>>>>> I found >>>>>> all sorts of stuff not working and added everything I found to >>>>>> the new >>>>>> guide. >>>>>> >>>>>> If we need a larger review community for the guide repo, than >>>>>> that is >>>>>> something Geoff and Ryan need to discuss I think. In these times >>>>>> that >>>>>> would be a great help, so we can get the new information out fast. >>>>>> >>>>>> >>>>>> Your thoughts? >>>>>> >>>>>> Best regards, >>>>>> John >>>>>> >>>>>> _______________________________________________ >>>>>> Maildev mailing list >>>>>> Maildev@lists.thunderbird.net >>>>>> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >>>>>> >>>>> >>>>> _______________________________________________ >>>>> Maildev mailing list >>>>> Maildev@lists.thunderbird.net >>>>> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >>>> >>>> >>>> _______________________________________________ >>>> Maildev mailing list >>>> Maildev@lists.thunderbird.net >>>> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >>> >>> _______________________________________________ >>> Maildev mailing list >>> Maildev@lists.thunderbird.net >>> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >> >> >> _______________________________________________ >> Maildev mailing list >> Maildev@lists.thunderbird.net >> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net > > _______________________________________________ > Maildev mailing list > Maildev@lists.thunderbird.net > http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net

Ok, than lets sort this out. What path should we take? 1. Ryan: Can we host our own wiki with custom css to make it fit into developer.thunderbird.net? Or can we style the mozilla wiki? 2. Geoff can handle all the WebExtension API stuff under his own regime 3. The wiki will contain all the information about upgrading AddOns? I of course do not want to loose Geoffs support! He has added new and important information to the new guide which where just recently added to the wiki as well. I just want to sort this out and minimize double efforts. Does anyone else care? For me this is pretty important as I want to get all the things we find out while upgrading our Addons back to the community, for everyone to find. At a single location. Best regards, John On 02.04.2019 04:58, Geoff Lankow wrote: > > The article I wrote on RTD was not intended to to contain every minute > detail. Others decided that it should be, which I just don't agree > with, although I didn't complain at the time. > > A wiki (not necessarily the one we currently have) is much better > suited as > > 1. anyone with an account can edit it. > 2. changes happen immediately and don't need anyone else's input. > 3. headings and bullet points is better for listing the information > than prose. > > I should've posted what I wrote on my blog and then there would be no > argument over what should or shouldn't be the content of it. As it > happens I never thought that RTD was the right place and I have been > meaning to get it copied on to developer.thunderbird.net. > > GL > > On 2/04/19 08:13, Ryan Sipes wrote: >> >> I'll let Geoff speak for himself, but from what I understand he was >> just saying that the stuff on the Wiki is more up-to-date than his >> documentation on RTDs. Really, this opens up a new conversation which >> is where is the best place to provide resources to add-ons >> developers. I just recently spun up developer.thunderbird.net and >> very soon I will start twisting arms to ensure everything that needs >> to be there is there. >> >> But since this other stuff is so new, not everyone contributing to >> Thunderbird is ensuring they are up-to-date. So they are not yet a >> reliable source of information. >> >> Ryan Sipes >> Community and Business Development Manager >> Thunderbird <https://thunderbird.net> >> >> On 4/1/19 12:35 PM, John Bieling wrote: >>> >>> >>>> The idea with the new developer docs is to consolidate as much >>>> documentation that is helpful to developers in one place. >>>> >>> That was my impression and that is why I proposed to do pull >>> requests, but Geoffs answer kinda contradicts that, as he wants to >>> have the details on the wiki. >>> >>> Why does Geoff object to have all the info we gathered available on >>> the main guide? It will never contain info about ALL the changes >>> (because probably nobody knows all of them), but it should contain >>> all we DO know about. Why spread it among two different resources? >>> >>> I am pretty lost with the current situation, as I thought Geoff >>> introduced the new guide as a replacement with a common the look and >>> feel for developer.thunderbird.net. >>> >>> >>> John >>> >>> >>> >>>> Ryan Sipes >>>> Community and Business Development Manager >>>> Thunderbird <https://thunderbird.net> >>>> >>>> On 4/1/19 4:44 AM, John Bieling wrote: >>>>> From the last mail exchange regarding this new guide, I would have >>>>> expected a different answer. Thanks for the clarification. >>>>> >>>>> John >>>>> >>>>> >>>>> >>>>> On 01.04.2019 12:11, Geoff Lankow wrote: >>>>>> >>>>>> Good. Things are working as intended. >>>>>> >>>>>> The page I wrote was /not/ intended to be a definitive guide to >>>>>> everything that has changed. It even says so in the introduction. >>>>>> Such information is much better suited to the wiki. >>>>>> >>>>>> GL >>>>>> >>>>>> On 1/04/19 22:59, John Bieling wrote: >>>>>>> Hi, >>>>>>> >>>>>>> I just saw, that someone added new information to >>>>>>> >>>>>>> https://wiki.mozilla.org/Thunderbird/Add-ons_Guide_63 >>>>>>> >>>>>>> But that guide was declared obsolete. The added information are >>>>>>> great >>>>>>> and helpful but I strongly suggest to add them to the new guide. >>>>>>> The new >>>>>>> guide is linked directly under >>>>>>> >>>>>>> https://developer.thunderbird.net >>>>>>> >>>>>>> as "Updating Extensions for 68" where you can fork it on github >>>>>>> and send >>>>>>> a pull request. >>>>>>> >>>>>>> >>>>>>> >>>>>>> I did the same! While updating my AddOn CategoryManager to TB68, >>>>>>> I found >>>>>>> all sorts of stuff not working and added everything I found to >>>>>>> the new >>>>>>> guide. >>>>>>> >>>>>>> If we need a larger review community for the guide repo, than >>>>>>> that is >>>>>>> something Geoff and Ryan need to discuss I think. In these times >>>>>>> that >>>>>>> would be a great help, so we can get the new information out fast. >>>>>>> >>>>>>> >>>>>>> Your thoughts? >>>>>>> >>>>>>> Best regards, >>>>>>> John >>>>>>> >>>>>>> _______________________________________________ >>>>>>> Maildev mailing list >>>>>>> Maildev@lists.thunderbird.net >>>>>>> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >>>>>>> >>>>>> >>>>>> _______________________________________________ >>>>>> Maildev mailing list >>>>>> Maildev@lists.thunderbird.net >>>>>> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >>>>> >>>>> >>>>> _______________________________________________ >>>>> Maildev mailing list >>>>> Maildev@lists.thunderbird.net >>>>> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >>>> >>>> _______________________________________________ >>>> Maildev mailing list >>>> Maildev@lists.thunderbird.net >>>> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >>> >>> >>> _______________________________________________ >>> Maildev mailing list >>> Maildev@lists.thunderbird.net >>> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >> >> _______________________________________________ >> Maildev mailing list >> Maildev@lists.thunderbird.net >> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net > > _______________________________________________ > Maildev mailing list > Maildev@lists.thunderbird.net > http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net

Let's try not to spread the canonical documentation out over multiple places. That's been the cause of much frustration over the years. We should find some place for this on developer.thunderbird.net While it's great that people contribute what they find, just dumping the text into a page is not great for readability. It needs some editorial touch to be kept consistent.  -Magnus On 02-04-2019 09:59, John Bieling wrote: > Ok, than lets sort this out. What path should we take? > > 1. Ryan: Can we host our own wiki with custom css to make it fit into > developer.thunderbird.net? Or can we style the mozilla wiki? > 2. Geoff can handle all the WebExtension API stuff under his own regime > 3. The wiki will contain all the information about upgrading AddOns? > > I of course do not want to loose Geoffs support! He has added new and > important information to the new guide which where just recently added > to the wiki as well. I just want to sort this out and minimize double > efforts. > > Does anyone else care? For me this is pretty important as I want to > get all the things we find out while upgrading our Addons back to the > community, for everyone to find. At a single location. > > Best regards, > John > > > > > On 02.04.2019 04:58, Geoff Lankow wrote: >> >> The article I wrote on RTD was not intended to to contain every >> minute detail. Others decided that it should be, which I just don't >> agree with, although I didn't complain at the time. >> >> A wiki (not necessarily the one we currently have) is much better >> suited as >> >> 1. anyone with an account can edit it. >> 2. changes happen immediately and don't need anyone else's input. >> 3. headings and bullet points is better for listing the information >> than prose. >> >> I should've posted what I wrote on my blog and then there would be no >> argument over what should or shouldn't be the content of it. As it >> happens I never thought that RTD was the right place and I have been >> meaning to get it copied on to developer.thunderbird.net. >> >> GL >> >> On 2/04/19 08:13, Ryan Sipes wrote: >>> >>> I'll let Geoff speak for himself, but from what I understand he was >>> just saying that the stuff on the Wiki is more up-to-date than his >>> documentation on RTDs. Really, this opens up a new conversation >>> which is where is the best place to provide resources to add-ons >>> developers. I just recently spun up developer.thunderbird.net and >>> very soon I will start twisting arms to ensure everything that needs >>> to be there is there. >>> >>> But since this other stuff is so new, not everyone contributing to >>> Thunderbird is ensuring they are up-to-date. So they are not yet a >>> reliable source of information. >>> >>> Ryan Sipes >>> Community and Business Development Manager >>> Thunderbird <https://thunderbird.net> >>> >>> On 4/1/19 12:35 PM, John Bieling wrote: >>>> >>>> >>>>> The idea with the new developer docs is to consolidate as much >>>>> documentation that is helpful to developers in one place. >>>>> >>>> That was my impression and that is why I proposed to do pull >>>> requests, but Geoffs answer kinda contradicts that, as he wants to >>>> have the details on the wiki. >>>> >>>> Why does Geoff object to have all the info we gathered available on >>>> the main guide? It will never contain info about ALL the changes >>>> (because probably nobody knows all of them), but it should contain >>>> all we DO know about. Why spread it among two different resources? >>>> >>>> I am pretty lost with the current situation, as I thought Geoff >>>> introduced the new guide as a replacement with a common the look >>>> and feel for developer.thunderbird.net. >>>> >>>> >>>> John >>>> >>>> >>>> >>>>> Ryan Sipes >>>>> Community and Business Development Manager >>>>> Thunderbird <https://thunderbird.net> >>>>> >>>>> On 4/1/19 4:44 AM, John Bieling wrote: >>>>>> From the last mail exchange regarding this new guide, I would >>>>>> have expected a different answer. Thanks for the clarification. >>>>>> >>>>>> John >>>>>> >>>>>> >>>>>> >>>>>> On 01.04.2019 12:11, Geoff Lankow wrote: >>>>>>> >>>>>>> Good. Things are working as intended. >>>>>>> >>>>>>> The page I wrote was /not/ intended to be a definitive guide to >>>>>>> everything that has changed. It even says so in the >>>>>>> introduction. Such information is much better suited to the wiki. >>>>>>> >>>>>>> GL >>>>>>> >>>>>>> On 1/04/19 22:59, John Bieling wrote: >>>>>>>> Hi, >>>>>>>> >>>>>>>> I just saw, that someone added new information to >>>>>>>> >>>>>>>> https://wiki.mozilla.org/Thunderbird/Add-ons_Guide_63 >>>>>>>> >>>>>>>> But that guide was declared obsolete. The added information are >>>>>>>> great >>>>>>>> and helpful but I strongly suggest to add them to the new >>>>>>>> guide. The new >>>>>>>> guide is linked directly under >>>>>>>> >>>>>>>> https://developer.thunderbird.net >>>>>>>> >>>>>>>> as "Updating Extensions for 68" where you can fork it on github >>>>>>>> and send >>>>>>>> a pull request. >>>>>>>> >>>>>>>> >>>>>>>> >>>>>>>> I did the same! While updating my AddOn CategoryManager to >>>>>>>> TB68, I found >>>>>>>> all sorts of stuff not working and added everything I found to >>>>>>>> the new >>>>>>>> guide. >>>>>>>> >>>>>>>> If we need a larger review community for the guide repo, than >>>>>>>> that is >>>>>>>> something Geoff and Ryan need to discuss I think. In these >>>>>>>> times that >>>>>>>> would be a great help, so we can get the new information out fast. >>>>>>>> >>>>>>>> >>>>>>>> Your thoughts? >>>>>>>> >>>>>>>> Best regards, >>>>>>>> John >>>>>>>> >>>>>>>> _______________________________________________ >>>>>>>> Maildev mailing list >>>>>>>> Maildev@lists.thunderbird.net >>>>>>>> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >>>>>>>> >>>>>>> >>>>>>> _______________________________________________ >>>>>>> Maildev mailing list >>>>>>> Maildev@lists.thunderbird.net >>>>>>> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >>>>>> >>>>>> >>>>>> _______________________________________________ >>>>>> Maildev mailing list >>>>>> Maildev@lists.thunderbird.net >>>>>> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >>>>> >>>>> _______________________________________________ >>>>> Maildev mailing list >>>>> Maildev@lists.thunderbird.net >>>>> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >>>> >>>> >>>> _______________________________________________ >>>> Maildev mailing list >>>> Maildev@lists.thunderbird.net >>>> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >>> >>> _______________________________________________ >>> Maildev mailing list >>> Maildev@lists.thunderbird.net >>> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >> >> _______________________________________________ >> Maildev mailing list >> Maildev@lists.thunderbird.net >> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net > > > _______________________________________________ > Maildev mailing list > Maildev@lists.thunderbird.net > http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net

I agree, I'm happy to create an entire group in DTN for "Update Add-ons for 68" or something like that. Anyone can send a pull request <https://github.com/thundernest/developer-docs> or I'd be cool with inviting folks to the Gitbook team that gives you a front-end for managing content on the site. All around, John, I hope to make it so easy to contribute to DTN that we have no need for a traditional wiki. Let me know if you have any ideas for how I can lower the barrier to entry. The way I see it is the first thing we could benefit from would be a transfer of the content on the Add-ons Guide <https://wiki.mozilla.org/Thunderbird/Add-ons_Guide_63> page on the wiki with any added insight you and other add-on authors have gained through updating your add-ons. Ryan Sipes Community and Business Development Manager Thunderbird <https://thunderbird.net> On 4/2/19 2:41 AM, Magnus Melin wrote: > > Let's try not to spread the canonical documentation out over multiple > places. That's been the cause of much frustration over the years. We > should find some place for this on developer.thunderbird.net > > While it's great that people contribute what they find, just dumping > the text into a page is not great for readability. It needs some > editorial touch to be kept consistent. > >  -Magnus > > On 02-04-2019 09:59, John Bieling wrote: >> Ok, than lets sort this out. What path should we take? >> >> 1. Ryan: Can we host our own wiki with custom css to make it fit into >> developer.thunderbird.net? Or can we style the mozilla wiki? >> 2. Geoff can handle all the WebExtension API stuff under his own regime >> 3. The wiki will contain all the information about upgrading AddOns? >> >> I of course do not want to loose Geoffs support! He has added new and >> important information to the new guide which where just recently >> added to the wiki as well. I just want to sort this out and minimize >> double efforts. >> >> Does anyone else care? For me this is pretty important as I want to >> get all the things we find out while upgrading our Addons back to the >> community, for everyone to find. At a single location. >> >> Best regards, >> John >> >> >> >> >> On 02.04.2019 04:58, Geoff Lankow wrote: >>> >>> The article I wrote on RTD was not intended to to contain every >>> minute detail. Others decided that it should be, which I just don't >>> agree with, although I didn't complain at the time. >>> >>> A wiki (not necessarily the one we currently have) is much better >>> suited as >>> >>> 1. anyone with an account can edit it. >>> 2. changes happen immediately and don't need anyone else's input. >>> 3. headings and bullet points is better for listing the information >>> than prose. >>> >>> I should've posted what I wrote on my blog and then there would be >>> no argument over what should or shouldn't be the content of it. As >>> it happens I never thought that RTD was the right place and I have >>> been meaning to get it copied on to developer.thunderbird.net. >>> >>> GL >>> >>> On 2/04/19 08:13, Ryan Sipes wrote: >>>> >>>> I'll let Geoff speak for himself, but from what I understand he was >>>> just saying that the stuff on the Wiki is more up-to-date than his >>>> documentation on RTDs. Really, this opens up a new conversation >>>> which is where is the best place to provide resources to add-ons >>>> developers. I just recently spun up developer.thunderbird.net and >>>> very soon I will start twisting arms to ensure everything that >>>> needs to be there is there. >>>> >>>> But since this other stuff is so new, not everyone contributing to >>>> Thunderbird is ensuring they are up-to-date. So they are not yet a >>>> reliable source of information. >>>> >>>> Ryan Sipes >>>> Community and Business Development Manager >>>> Thunderbird <https://thunderbird.net> >>>> >>>> On 4/1/19 12:35 PM, John Bieling wrote: >>>>> >>>>> >>>>>> The idea with the new developer docs is to consolidate as much >>>>>> documentation that is helpful to developers in one place. >>>>>> >>>>> That was my impression and that is why I proposed to do pull >>>>> requests, but Geoffs answer kinda contradicts that, as he wants to >>>>> have the details on the wiki. >>>>> >>>>> Why does Geoff object to have all the info we gathered available >>>>> on the main guide? It will never contain info about ALL the >>>>> changes (because probably nobody knows all of them), but it should >>>>> contain all we DO know about. Why spread it among two different >>>>> resources? >>>>> >>>>> I am pretty lost with the current situation, as I thought Geoff >>>>> introduced the new guide as a replacement with a common the look >>>>> and feel for developer.thunderbird.net. >>>>> >>>>> >>>>> John >>>>> >>>>> >>>>> >>>>>> Ryan Sipes >>>>>> Community and Business Development Manager >>>>>> Thunderbird <https://thunderbird.net> >>>>>> >>>>>> On 4/1/19 4:44 AM, John Bieling wrote: >>>>>>> From the last mail exchange regarding this new guide, I would >>>>>>> have expected a different answer. Thanks for the clarification. >>>>>>> >>>>>>> John >>>>>>> >>>>>>> >>>>>>> >>>>>>> On 01.04.2019 12:11, Geoff Lankow wrote: >>>>>>>> >>>>>>>> Good. Things are working as intended. >>>>>>>> >>>>>>>> The page I wrote was /not/ intended to be a definitive guide to >>>>>>>> everything that has changed. It even says so in the >>>>>>>> introduction. Such information is much better suited to the wiki. >>>>>>>> >>>>>>>> GL >>>>>>>> >>>>>>>> On 1/04/19 22:59, John Bieling wrote: >>>>>>>>> Hi, >>>>>>>>> >>>>>>>>> I just saw, that someone added new information to >>>>>>>>> >>>>>>>>> https://wiki.mozilla.org/Thunderbird/Add-ons_Guide_63 >>>>>>>>> >>>>>>>>> But that guide was declared obsolete. The added information >>>>>>>>> are great >>>>>>>>> and helpful but I strongly suggest to add them to the new >>>>>>>>> guide. The new >>>>>>>>> guide is linked directly under >>>>>>>>> >>>>>>>>> https://developer.thunderbird.net >>>>>>>>> >>>>>>>>> as "Updating Extensions for 68" where you can fork it on >>>>>>>>> github and send >>>>>>>>> a pull request. >>>>>>>>> >>>>>>>>> >>>>>>>>> >>>>>>>>> I did the same! While updating my AddOn CategoryManager to >>>>>>>>> TB68, I found >>>>>>>>> all sorts of stuff not working and added everything I found to >>>>>>>>> the new >>>>>>>>> guide. >>>>>>>>> >>>>>>>>> If we need a larger review community for the guide repo, than >>>>>>>>> that is >>>>>>>>> something Geoff and Ryan need to discuss I think. In these >>>>>>>>> times that >>>>>>>>> would be a great help, so we can get the new information out >>>>>>>>> fast. >>>>>>>>> >>>>>>>>> >>>>>>>>> Your thoughts? >>>>>>>>> >>>>>>>>> Best regards, >>>>>>>>> John >>>>>>>>> >>>>>>>>> _______________________________________________ >>>>>>>>> Maildev mailing list >>>>>>>>> Maildev@lists.thunderbird.net >>>>>>>>> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >>>>>>>>> >>>>>>>> >>>>>>>> _______________________________________________ >>>>>>>> Maildev mailing list >>>>>>>> Maildev@lists.thunderbird.net >>>>>>>> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >>>>>>> >>>>>>> >>>>>>> _______________________________________________ >>>>>>> Maildev mailing list >>>>>>> Maildev@lists.thunderbird.net >>>>>>> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >>>>>> >>>>>> _______________________________________________ >>>>>> Maildev mailing list >>>>>> Maildev@lists.thunderbird.net >>>>>> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >>>>> >>>>> >>>>> _______________________________________________ >>>>> Maildev mailing list >>>>> Maildev@lists.thunderbird.net >>>>> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >>>> >>>> _______________________________________________ >>>> Maildev mailing list >>>> Maildev@lists.thunderbird.net >>>> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >>> >>> _______________________________________________ >>> Maildev mailing list >>> Maildev@lists.thunderbird.net >>> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net >> >> >> _______________________________________________ >> Maildev mailing list >> Maildev@lists.thunderbird.net >> http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net > > _______________________________________________ > Maildev mailing list > Maildev@lists.thunderbird.net > http://lists.thunderbird.net/mailman/listinfo/maildev_lists.thunderbird.net