Re: Getting editorial assistance

[Ali Spivak]

Hi,

I'm copying the MDN writers list - we should have a few folks there who
could help out with editing and review.

-ali

On Mon, May 16, 2016 at 10:00 AM, JR Conlin <jco...@mozilla.com> wrote:

> Hi Ali,
> I'm a back-end engineer working on the Web Push project. <
> https://developer.mozilla.org/en-US/docs/Web/API/Push_API> Web Push
> allows Application Servers to send messages through our system and to
> Applications running on user browsers. We have excellent documentation for
> how Applications can process incoming push events <see
> https://serviceworke.rs>, but we really don't have much information for
> Application Server back end developers.
>
> Sending a push notification is not as simple as "Send your POST to this
> URL". Because of privacy concerns and several other reasons, we require
> fairly complicated encryption. The encryption method the specification
> requires is complicated.
>
> I know that your team is overwhelmed, so I'm not going to ask that anyone
> there dig into the brain melting horror that is ECDH encryption, but I
> would greatly appreciate if I could get someone to at least review and edit
> the document I'm putting together. (I am experienced with editorial process
> and WELCOME any and all criticism. My goal is to create something readable,
> not pander to my ego)
>
> Is there anyone I could contact about this? Is there a different approach
> I could consider? Thanks!
>



--
ali spivak
Head of Developer Marketing
asp...@mozilla.com

[jr conlin]

The document is currently about 6 pages, but I'd like to try and keep it
under 10. Mostly because asking folks to read more than that guarantees
they won't read any of it.

I'm also going to try to pair it up with referenced sources like a
python & javascript library as well as a Web Push Data Test Page I've
built a while back:
https://mozilla-services.github.io/WebPushDataTestPage/ I'm hoping that
I can give something a bit more detailed than an introduction, but a bit
less than delving into the intricacies of Diffie Hellman.

I'm also hoping to have something editor ready by the end of the week.

thanks!

On 5/16/2016 10:19 AM, Jean-Yves Perrier wrote:
> Hi!
>
> Chris has worked on Push API docs before, so he is likely the most
> adequate person to work with you there.
>
> Just to evaluate the amount of work it will be, how many pages do we
> expect to be reviewed there: 5-10- more?
>
> Also what would be your timeframe (more or less). Pages ready in 1
> week or 2, longer. Do you need a 1-2 h crash course on MDN?
>
> --
> Jean-Yves
> MDN Content Lead

> Jean-Yves Perrier
> Senior St. Project Manager, Developer Documentation / MDN

[jr conlin]

Thanks Chris!
I'll send you the doc when it's reasonably ready and we can work from
there when you have time.


On 5/16/2016 11:18 AM, Chris Mills wrote:
> Hi there!
>
> I am happy to take this on for you — as J-Y said, I’ve got the most Push experience here (I’m not an expert in server-side stuff, but I am willing to learn.)
>
> I wrote the MDN Push API docs, but I’m always happy to extend them to include more useful coverage. The server-side info is definitely thin on the ground.
>
> The timing sounds good - I am busy this week and next with our current sprint, but I could put these docs as a task in our next sprint.
>
> Chris Mills
> Senior tech writer || Mozilla
> developer.mozilla.org || MDN
> cmi...@mozilla.com || @chrisdavidmills

>> _______________________________________________
>> dev-mdc mailing list
>> dev...@lists.mozilla.org
>> https://lists.mozilla.org/listinfo/dev-mdc
>> MDN contributor guide: http://bit.ly/ContributorGuide
>> Doc project Trello board: https://trello.com/b/HAhl54zz/status

[Jean-Yves Perrier]

[Chris Mills]

Hi there!

I am happy to take this on for you — as J-Y said, I’ve got the most Push experience here (I’m not an expert in server-side stuff, but I am willing to learn.)

I wrote the MDN Push API docs, but I’m always happy to extend them to include more useful coverage. The server-side info is definitely thin on the ground.

The timing sounds good - I am busy this week and next with our current sprint, but I could put these docs as a task in our next sprint.

Chris Mills
Senior tech writer || Mozilla
developer.mozilla.org || MDN
cmi...@mozilla.com || @chrisdavidmills

> On 16 May 2016, at 18:52, jr conlin <jco...@mozilla.com> wrote:
>
> The document is currently about 6 pages, but I'd like to try and keep it
> under 10. Mostly because asking folks to read more than that guarantees
> they won't read any of it.
>
> I'm also going to try to pair it up with referenced sources like a
> python & javascript library as well as a Web Push Data Test Page I've
> built a while back:
> https://mozilla-services.github.io/WebPushDataTestPage/ I'm hoping that
> I can give something a bit more detailed than an introduction, but a bit
> less than delving into the intricacies of Diffie Hellman.
>
> I'm also hoping to have something editor ready by the end of the week.
>
> thanks!
>
> On 5/16/2016 10:19 AM, Jean-Yves Perrier wrote: