Hacktoberfest 2026 : les issues que les mainteneurs ont marquées pour octobre, ouvertes et accessibles aux débutants. Parcourir les issues Hacktoberfest

`nbdev_clean` documentation partly wrong

Ouverte
#1,480 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Évaluation

Difficulté
1/5
Temps estimé
Moins d'une heure
Accessibilité débutants
35/100
Type d'issue
Documentation
Clarté
Clairement spécifiée
Activité
À l'abandon
Stack technique
jupyter-notebook, python
Domaine
documentation

Piste de recherche

Commencez par l’entrée liée de la documentation de l’API pour nbdev_clean et comparez la description de fname avec le comportement de la commande indiqué dans l’issue. Mettez à jour la documentation afin de distinguer un seul nom ou chemin de notebook des arguments non pris en charge pour plusieurs fichiers et des motifs glob, puis vérifiez les exemples documentés.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

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!

Langage dominant
Jupyter Notebook
Étoiles
5.3k
Forks
516
Merge moyen
2 j 7 h
PR mergées (30 j)
1

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de AnswerDotAI/nbdev

Toutes les issues de AnswerDotAI/nbdev

Issues similaires

Plus d'issues Documentation

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.