search

graphql / foundation

GraphQL Foundation Charter and Legal Documents
https://graphql.org
MIT License
87 stars 26 forks source link

Launch GraphQL Foundation Monthly Newsletter #26

Open caniszczyk opened 4 years ago

Urigo commented 4 years ago

@caniszczyk What should be the next steps? Maybe it's worth reaching our to Prisma about their GraphQL Weekly newsletter?

They've done great work there but it seems to be a bit slow recently and maybe collaborating on that could be a good idea?

IvanGoncharov commented 4 years ago

Maybe it's worth reaching our to Prisma about their GraphQL Weekly newsletter?

@Urigo I think it's a great idea. AFAIK it's currently maintained by Novvum guys and they are members of the foundation.

Urigo commented 4 years ago

@IvanGoncharov do you know their Github usernames? Can you tag them here?

Urigo commented 4 years ago

cc @rohit-ravikoti @rajinwonderland

rajinwonderland commented 4 years ago

Hey @Urigo! Yes! We have been a bit understaffed lately, so haven't had much time to update it, but shouldn't take much to flip it over to the foundation. How should we proceed with this?

Urigo commented 4 years ago

@rajinwonderland that's amazing and extremely generous!!

I think @brianwarner & @caniszczyk should follow with next steps?

rajinwonderland commented 4 years ago

Sweet! We'll be glad to help in anyway possible 👍

brianwarner commented 4 years ago

Yep! Raj, I'll connect with you separately.

caniszczyk commented 4 years ago

We have started a monthly newsletter draft here: https://docs.google.com/document/d/14ZwpLnIuiSnHfD0zSb2gLoC30MirG1LHlpcF3LFsPFM/edit?ts=5f4fbf18

The idea is to do this in the open completely and get feedback from folks before posting.

benjie commented 4 years ago

I was working on the Tagged type RFC just earlier today as it happens. Can I suggest text a little more like this? (Feel free to add links/styles/brevity/otherwise edit as appropriate.)

Tagged Type RFC

This is an RFC for a new "Tagged" type to be added to GraphQL, to help address the input polymorphism feature gap. Originally proposed as the @oneField directive, the Tagged type has evolved into an entire new type in the type system, and is currently the lead proposal from the Input Unions Working Group.

A Tagged type defines a list of named member fields each with an associated type (like the fields in Object and Input Object types); but with the stipulation that exactly one of these fields must be present (no more, no less). Depending on the types of the member fields, a Tagged type could be appropriate for input, output, or both, which is proving to be quite controversial; it's possible that the tagged type might be scoped to input only before release. The Tagged type was most recently introduced to the GraphQL Working Group in August and is undergoing feedback and revision before an expected update with the working group in October or November.

If you have use-cases for input polymorphism, please take a look - feedback is very welcome.

benjie commented 4 years ago

Separately, can I suggest re-ordering of the items.

  1. GraphQL over WebSockets refresh - top priority because this affects all the current users of GraphQL over websockets, and it would be great to get buy-in on the new language-agnostic spec from the community (and also it needs more eyes for security, performance and scalability reviews)
  2. Tagged type RFC - next highest priority because it's a significant change to the GraphQL spec and needs more eyes
  3. Field coordinates - a relatively minor proposal about standardizing how we refer to things in GraphQL; it's useful for all GraphQL people to know about this, but not as important as the two above
  4. DocumentNode generics - I, personally, am very excited for this! But it's very TypeScript specific, so I think all of the above have higher priority to the GraphQL community as a whole; sorry @dotansimha :grimacing:
IvanGoncharov commented 4 years ago

@caniszczyk A few suggestions from me:

Urigo commented 4 years ago

Thank you @caniszczyk for the update!

  1. When are you planning to publish the newsletter?
  2. Also what would be the cadence, monthly?
  3. I do think the newsletter is a great platform to highlight the work that has been done on the graphql-js library (and all the other Foundation assets). It also is probably the only platform. So maybe we could have section like "Last month on the foundation's projects" and have a few bullets points on what happened. There we could also highlight TypedDocumentNode among others
  4. @brianwarner could you update on the conversation you had with @rajinwonderland and what was the result?
Urigo commented 4 years ago

Also adding @acao to share more work from GraphiQL and stuff

Urigo commented 4 years ago

also - can we add a place to accumulate things between newsletters? like a backlog? or we could just use this issue as a backlog?

rajinwonderland commented 4 years ago

Hey @Urigo 👋

I think @brianwarner most likely had a conversation with @rohit-ravikoti.

If there's anything I can answer though, I'd be happy to! But I think Rohit might have more context

mayaptos commented 4 years ago

Hi All - I will be putting the blog together each month and your feedback and contributions are extremely helpful. Keep it up!

@benjie Thanks for the re-order and the updated text

@IvanGoncharov Great stuff. Thanks for contributing

@Urigo - We plan to publish ASAP and the cadence will be monthly. Given the Sept WG meeting just ocured the next one will post sooner, but in general it'll be a monthly cadence.

Happy to add more info on projects. That would be great. They just need to be supplied to me and we will add them.

mayaptos commented 4 years ago

All of your feedback and contributions has been added to the blog. Let me know if we are missing anything. otherwise we will get this posted early next week! https://docs.google.com/document/d/14ZwpLnIuiSnHfD0zSb2gLoC30MirG1LHlpcF3LFsPFM/edit?ts=5f46a3be#

Urigo commented 4 years ago

thank you @mayaptos ! I've added a couple of suggestion to the doc itself.

Urigo commented 4 years ago

and I still hope that @acao will get to add his updates as well, but I can't add them myself

Urigo commented 4 years ago

another question - on which channels will you spread the newsletter? and how can people subscribe? Will you use the official social accounts to promote it?

caniszczyk commented 4 years ago

1) we will post to the blog here https://foundation.graphql.org/news/ 2) we will setup a newsletter form using an internal LF system (we have marketing cloud behind the scenes) 3) yes, we'd love too!

The goal is to start doing this every month and solicit input from the community

Urigo commented 3 years ago

Hi everyone!

In order to increase the spread of this important newsletter, Prisma has agreed to also publish those updates under the GraphQL Weekly newsletter as well!

Together with @chenkie from Prisma, I helped take the first edition they published and merge all the previous editions we've published till now into one.

Check it out here: https://www.graphqlweekly.com/issues/209/#content

This is a first try, please review and give your feedback so we could further improve it and make sure it follows our required guidelines.

mayaptos commented 3 years ago

Thanks @Urigo ! Could we get a link back to the newsletter. I don't see one on the Graph weekly site

Urigo commented 3 years ago

@mayaptos yes I saw that now, in looks different on the newsletter itself and I've mentioned it to @chenkie.

He said they are working on it, @chenkie could you give on update about that when you'll get a chance?

In the meantime, I'll try to put here some screenshots from the actual newsletter here for review:

Screen Shot 2020-10-31 at 11 38 24 AM Screen Shot 2020-10-31 at 11 38 33 AM Screen Shot 2020-10-31 at 11 38 45 AM
Urigo commented 3 years ago

another issue was that they could current only have one link per items and not links in the texts. I hope they could improve on that as well soon because it helped create better context.

chenkie commented 3 years ago

Outstanding items that I'm working on to round out the GraphQL Weekly Foundation Edition newsletter: