Recommend a canonical graphql.config.yml for Harper schemas
Los mantenedores suelen responder en 2 días
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 3/5
- Tiempo estimado
- 1-2 días
- Aptitud para principiantes
- 58/100
- Tipo de issue
- Documentación
- Claridad
- Bastante claro
- Estado de actividad
- Tranquilo
- Stack tecnológico
- nodejs
- Área
- documentation
Línea de trabajo
Comienza con reference/database/schema.md y ejecuta la búsqueda rg mencionada en reference/, learn/ y fabric/. Verifica si npm create harper@latest genera graphql.config.yml y compara el archivo propuesto con las herramientas compatibles con el proyecto. El trabajo estará terminado cuando se documenten la recomendación confirmada, la ubicación del esquema de directivas y el comportamiento del scaffold, sin dejar sin resolver la elección de herramientas.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
Gap
The harper-best-practices skill rule for schema-design-tooling recommends a specific `graphql.config.yml` setup so editors and the GraphQL language server can resolve Harper directives:
```yaml
schema:
- node_modules/harper/schema.graphql
- schemas/*.graphql
```
(Pointing the language server at `node_modules/harper/schema.graphql` is the part that's Harper-specific — it's where `@table`, `@indexed`, etc. are defined.)
None of this is in the docs. `rg "graphql.config" reference/ learn/ fabric/` returns nothing.
Ask
Decide whether `graphql.config.yml` is the recommended tooling pattern (vs. `graphqlrc.yml`, vs. configuring per-editor, vs. just documenting where the directive schema lives without prescribing a tooling file). If yes:
- Add a short subsection to `reference/database/schema.md` (or a new page under `reference/database/`) showing the recommended file and what each entry does.
- Note that `node_modules/harper/schema.graphql` is the canonical directive source so readers can also point other tools at it.
- Mention that `npm create harper@latest` scaffolds this file (if it does — needs confirmation).
Context
Surfaced by a reverse gap-scan of the harper-best-practices skill rules.
— Claude (Opus 4.7), on behalf of @kriszyp
- Lenguaje dominante
- MDX
- Estrellas
- 9
- Forks
- 9
- Merge medio
- 2 d 23 h
- PR fusionados (30 d)
- 26
Preparar el entorno
- Sin Dockerfile ni archivo de Docker Compose
- Sin plantilla de pull request
- Leer la guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de HarperFast/documentation
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 90/100
HarperFast/documentation#690 ·
Los mantenedores suelen responder en 2 días
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
HarperFast/documentation#677 ·
Los mantenedores suelen responder en 2 días
-
Document markCredentialRejection / credentialRejectionError, the server.getUser rejection tagAbierto
Dificultad 2/5 Medio día Aptitud para principiantes 88/100
HarperFast/documentation#675 ·
Los mantenedores suelen responder en 2 días
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 92/100
HarperFast/documentation#665 ·
Los mantenedores suelen responder en 2 días
-
Add Harper deploy behaviorAbiertocontent
Dificultad 2/5 1-3 horas Aptitud para principiantes 74/100
HarperFast/documentation#478 ·
Los mantenedores suelen responder en 2 días
Todos los issues de HarperFast/documentation
Issues similares
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 88/100
zerocracy/judges-action#2730 ·
Los mantenedores suelen responder en 8 días
-
[workshop-sim] Improve: Add a required self-check gate to the agentic-workflows concept pageAbiertofeedback simulation workshop
Dificultad 2/5 1-3 horas Aptitud para principiantes 62/100
githubnext/gh-aw-workshop#4417 ·
Los mantenedores suelen responder en 1 día
-
documentation Good First Issue hacktoberfest Non-Code
Dificultad 2/5 1-3 horas Aptitud para principiantes 88/100
hiero-ledger/hiero-sdk-js#4488 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 88/100
crazy-goat/rabbit-stream#830 ·
Los mantenedores suelen responder en 1 día
-
sync-en
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
Los mantenedores suelen responder en 1 día