Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

docs: API.md still documents Spec::layer_sql/stat_sql removed in #569

Abierto Apto para principiantes
  • ¿Algo no está bien?
#590 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
1/5
Tiempo estimado
Menos de una hora
Aptitud para principiantes
88/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
rust
Área
documentation

Línea de trabajo

Las referencias obsoletas están en src/doc/API.md, en la sección “Query Introspection Methods” alrededor de la línea 268: un par de filas de tabla para layer_sql / stat_sql y líneas de ejemplo que llaman a spec.layer_sql(i) / spec.stat_sql(i). Busca en el repositorio layer_sql y stat_sql para confirmar que nada más de la documentación las menciona. Está terminado cuando se eliminan esas filas y líneas de ejemplo, no queda ninguna referencia y la nota opcional sobre la generación de SQL en la capa de dialecto se añade o se omite conscientemente.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

src/doc/API.md still documents Spec::layer_sql() and Spec::stat_sql(), but these methods were removed in #569 (afe60e64).

The affected section is "Query Introspection Methods" (around line 268): the table lists layer_sql / stat_sql, and the example below it calls spec.layer_sql(i) / spec.stat_sql(i), which no longer compiles against main.

For context: these accessors were already vestigial before removal — since #82, Spec::new() populated the backing fields with vec![None; ...], so they returned None in every released crate. The docs made the dead API look live (this confused at least one downstream binding — posit-dev/ggsql-python — into mirroring it).

Suggested fix: drop the two rows from the introspection table and the corresponding lines from the example. It may also be worth a sentence in that section noting that per-layer SQL is constructed centrally through the dialect layer at execution time and is no longer exposed on Spec.

Lenguaje dominante
Rust
Estrellas
565
Forks
31
Merge medio
2 d 10 h
PR fusionados (30 d)
17

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de posit-dev/ggsql

Todos los issues de posit-dev/ggsql

Issues similares

Más issues de Rust

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.