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

`nbdev_clean` documentation partly wrong

Abierto
#1,480 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
1/5
Tiempo estimado
Menos de una hora
Aptitud para principiantes
35/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Estancado
Stack tecnológico
jupyter-notebook, python

Línea de trabajo

Comienza en la entrada enlazada de la documentación de la API para nbdev_clean y compara la descripción de fname con el comportamiento del comando indicado en el issue. Actualiza la documentación para distinguir un único nombre o ruta de notebook de los argumentos no compatibles para varios archivos y patrones glob, y luego verifica los ejemplos documentados.

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

Descripción

bug

I was trying out nbdev_clean and I realized the documentation is not completely right, which caused me some confusion.
In the documentation (https://nbdev.fast.ai/api/clean.html#nbdev_clean) it says:

fname str None A notebook name or glob to clean

but this is not true, it accepts a single notebook name or a path, but not a glob (see detailed below). Maybe this should be changed to avoid confusion, cause it took me a while to understand what works and what doesn't, and I only figured with the help of old issues.

what works:

  • one single file (e.g. nbdev_clean --fname nb1.ipynb)
  • a path (e.g. nbdev_clean --fname ./)

what does not work:

  • passing several files (e.g. nbdev_clean --fname nb1.ipynb nb2.ipynb)
  • a glob (e.g. nbdev_clean --fname *.ipynb)
  • a path with a glob (e.g. nbdev_clean --fname ./*.ipynb)

Very cool library and features otherwise!

Lenguaje dominante
Jupyter Notebook
Estrellas
5.3k
Forks
517
Merge medio
1 min
PR fusionados (30 d)
3

Preparar el entorno

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 AnswerDotAI/nbdev

Todos los issues de AnswerDotAI/nbdev

Issues similares

Más issues de Documentation

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.