Python documentation in Texinfo format: Problems with `dircategory` and `direntry` commands
Personne n'a encore pris cette issue.
- Langage dominant
- Python
- Étoiles
- 77.2k
- Forks
- 35.9k
- Métriques de merge des PR
- Métriques de PR en attente
Description
Documentation
The Python documentation could be downloaded in Texinfo and Info format.
Which is great, I'm very very thankful for it.
But their is multiple problems, in the python.texi file, with the @dircategory and @direntry commands.
The @dircategory is now set to "Miscellaneous". It should be set to a more descriptive category. Like "Programming" or "Programming language" or "Python". A "Python" category could be re-used by other manuals related to Python. For example a manual for a Python framework or library.
In the @direntry command:
- The info file name, in parenthesis, should not include the
.infoextension [1] - The menu entry description should be more descriptive than "One line description of project"
[1] https://www.gnu.org/software/texinfo/manual/texinfo/texinfo.html#Listing-a-New-Info-File
Guide de contribution
Ouvrir le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Piste de recherche
Ouvrez python.texi et examinez ses commandes @dircategory et @direntry, puis comparez leurs valeurs actuelles avec les recommandations de Texinfo liées dans l’issue. C’est terminé lorsque la catégorie est descriptive, que le nom du fichier Info omet l’extension .info et que la description du menu identifie la documentation Python au lieu d’utiliser le texte d’espace réservé.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Évaluation
- Stack technique
- python
- Domaine
- documentation
- Type d'issue
- Documentation
- Difficulté
- 1/5
- Temps estimé
- 1-3 heures
- Activité
- À l'abandon
- Clarté
- Clairement spécifiée
- Accessibilité débutants
- 35/100