graphile / graphile/graphile.github.io

Website TODO list

Aperta
#164 5 commenti 3 reazioni 0 assegnatari Vedi su GitHub
Lingua principale
SCSS
Stelle
27
Fork
126
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Descrizione

BENJIE'S NOTE: this post was originally written by @calebmer on the PostGraphQL repo (since renamed to PostGraphile); since then we have built a website (https://graphile.org) but many of these points are still salient so we'll keep this issue open until they're dealt with.

~~PostGraphQL needs a documentation/marketing website. As a frontend engineer I’d love to build it myself, but at the same time PostGraphQL needs improvements in areas like performance. Here is an outline for what I want in the site (of course these specifications are subject to change):~~

- [x] An attractive landing page.
- [ ] An easily accessible GraphiQL interface (this will probably need to be hosted on Heroku).
- [ ] A super basic getting started article.
- [x] Forum example tutorial.
- [ ] Helpful articles:
- [x] Example Queries.
- [ ] Documenting your schema (with Postgres `COMMENT`).
- [ ] Deploying PostGraphQL with Docker.
- [ ] Deploying PostGraphQL with PM2.
- [ ] Extending your database with triggers and `LISTEN`/`NOTIFY`.
- [ ] Writing JavaScript or Ruby in your Postgres logic.
- [ ] Understanding graph database terms in GraphQL.
- [ ] Backing up your Postgres database.
- [ ] Why you should use PostGraphQL (persuasive, stop overengineering, etc.)
- [ ] Documentation.

…and here’s a quick outline for documentation:
- [ ] Tables.
- [ ] Queries.
- [ ] Relationships.
- [ ] Unique keys.
- [ ] Mutations.
- [ ] Procuedures.
- [ ] Mutations.
- [ ] Queries.
- [ ] Connections.
- [ ] Computed fields.
- [ ] Custom types.
- [ ] Domain types.
- [ ] Enum types.
- [ ] Composite types.
- [ ] Authentication/Authorization.
- [x] PostGraphQL as a CLI tool.
- [ ] PostGraphQL as HTTP middleware, basic examples of the web techs would be awesome:
- [ ] `http`
- [ ] `express`
- [ ] `connect`
- [ ] `koa`

Guida per i contributori

Nessuna guida per i contributori indicizzata per questo repository

Direzione di ricerca

This issue is a broad TODO list for the graphile.github.io website and names no files or tests. Review the existing website and the unchecked checklist items first; completion would require finishing a clearly selected documentation or website task and checking it off.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Valutazione

Stack tecnologico
docker, express, javascript, postgresql, ruby, scss
Ambito
documentation, web-dev
Tipo di issue
Documentazione
Difficoltà
5/5
Tempo stimato
Più di una settimana
Stato di attività
Ferma
Chiarezza
Da chiarire
Idoneità per principianti
20/100

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.