Thanks Shane. This seems to be coming along really well! I added a few more comments & questions.
On Tue, Feb 12, 2019 at 6:35 AM Shane Tomlinson <stomlin...@mozilla.com> wrote: > Since documentation was a hot topic of conversation last night, I figured > I'd post a very rough draft of the relier checklist > <https://docs.google.com/document/d/18l-EKwDyKwnUYUsvtud7j6AwfOe_ZA93YEkrBIjJe1Y/edit#heading=h.xr0oqh70wemf> > I > wrote about earlier in the quarter. The feedback you provided was very > helpful in pointing out areas of confusion, and I hope we can use that > feedback to minimize friction and confusion for future reliers. > > My request is simple, more feedback! It's still a bit hand-wavy, the hope > is to provide reliers with a page or two of guidance that allows them to > run from top to bottom and say "yup, did that, that too, that's not > applicable," and by the end feel somewhat confident their integration will > "Just Work". > > Next steps: > > - Further refine the checklist (nudge nudge, more feedback please!) > - Add a small bit of context for each heading > - Put the content up in a public place so we can point reliers at it > - Finally, build documentation around each of the important concepts > - Work with John and Grace to understand what they are working and how > to combine forces > > I'm not sure how long to wait before putting the checklist on the AS site, > it seems like even in its current state the checklist could be useful for > reliers looking to integrate. > > Shane > > > On Wed, Jan 9, 2019 at 6:14 PM Julie McCracken <jmccrac...@mozilla.com> > wrote: > >> + Tony Cinotto >> >> On Wed, Jan 9, 2019 at 9:49 AM Matthew Miller <m_an...@mozilla.com> >> wrote: >> >>> Thanks for starting this. I've added a couple of comments and >>> suggestions. I'll be happy to help flesh things out and/or review >>> content as this progresses. >>> >>> >>> - m&m >>> Matthew A. Miller >>> Mozilla >>> >>> On 19/01/09 03:10, Shane Tomlinson wrote: >>> > Hi! >>> > >>> > Over the past couple of months it has become abundantly clear that we >>> > (FxA) do not provide sufficient guidance to new OAuth reliers on either >>> > the mechanics of integrating with FxA or the responsibilities of doing >>> > so. A few quick examples: >>> > >>> > 1. We have seen multiple instances where "email-first" reliers did not >>> > know they needed to integrate with our metrics pipeline. >>> > 2. Nearly everyone asks which scopes they need. >>> > 3. For GDPR compliance, all reliers should delete user data whenever a >>> > user deletes their FxA account. >>> > >>> > I want to document things like these so that new reliers can get up and >>> > running with minimal fuss and minimal confusion. I have started an >>> > outline of topics to cover >>> > < >>> https://docs.google.com/document/d/18l-EKwDyKwnUYUsvtud7j6AwfOe_ZA93YEkrBIjJe1Y/edit >>> > and >>> > am sharing this outline in its infancy to ask for your help in adding >>> > topics you feel should be covered. >>> > >>> > I have cc'd several folks who have recently gone through the >>> integration >>> > process and have felt the pain firsthand. They have the best knowledge >>> > of anybody about what info they wish they had. >>> > >>> > Thanks, >>> > Shane >>> >>> -- >>> You received this message because you are subscribed to the Google >>> Groups "Application Services" group. >>> To unsubscribe from this group and stop receiving emails from it, send >>> an email to application-services+unsubscr...@mozilla.com. >>> To post to this group, send email to application-servi...@mozilla.com. >>> >>
_______________________________________________ Dev-fxacct mailing list Dev-fxacct@mozilla.org https://mail.mozilla.org/listinfo/dev-fxacct