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
