Website

[jasonkuhrt]

We would like a website

Why

• introducing the tool
• offering docs
  • guide organized by topic/domain
  • api reference documentation
  • recipes (problem-solution)
  • principals and architecture
  • compare & contrast
• community hub
• hosting a blog
• brand (aka: giving confidence to user base that we're invested)

References / Anti-References (tbd)

https://relay.dev/en/

• intro / api / guide / principals

https://vuejs.org/

• guide / api / style / examples / cookbook / video

https://reactjs.org/

• home page code examples
• home page linked tutorial
• api / testing / hooks / concepts / faq / ...

https://www.keystonejs.com/

• api / guide / quick start / packages
• super fast loading docs

https://hasura.io/

• heavy marketing
• bad doc experience (compare to keystone, for example)

https://www.apollographql.com/

• heavy marketing
• home page linked tutorial
• slow loading docs (!)

Content

Formally Tracked

• [ ] #230
• [ ] #228
• [ ] #227
• [x] #229
• [ ] #236
• [ ] #237
• [ ] #238
• [x] #239
• [ ] #314

Other Ideas

Community Hub

• currently pinned github issues
• core team
• contributors
• release history
• slack link
• current sprint
  • goal
  • issues
  • ends on

Branding

• minimal
• focus on great great great typography typography typography typography ...
• dark [theme]
• understated before overstated tone
• no hype, that's the users' job (if we do ours)
• no putdowns of others' work
• community oriented (not mount olympus)

[jasonkuhrt]

@nikolasburk any feedback would be appreciated.

[jasonkuhrt]

@schickling had the idea of a compare/contrast section. Because GraphQL is still a relatively new technology and there is a lot of varying tools at different levels of abstraction, it probably can take quite some time to go from new user to I-feel-comfort-with-the-ecosystem and more specifically, where does graphql-santa fit into it.

+#### Compare & Contrast
+
+Because GraphQL is still a relatively new technology and there is a lot of varying tools at different levels of abstraction, it probably can take quite some time to go from new user to I-feel-comfortable-with-the-ecosystem and more specifically, where does `graphql-santa` fit into it.
+
+- TypeGraphQL
+- Nexus
+- `nexus-prisma`
+- KeyStone.js
+- Apollo Server
+- Apollo Client
+- Apollo Engine
+- Relay
+- ...

[jasonkuhrt]

Removing blog idea from this epic

- _blog_

- - post per stable release
- - case-studies
- - ...

[jasonkuhrt]

Clean example of docs https://gcanti.github.io/fp-ts/.