python / python/docs-community
ABC documentation needs more details on usage
Personne n'a encore pris cette issue.
- Langage dominant
- Makefile
- Étoiles
- 55
- Forks
- 26
- Métriques de merge des PR
- Aucune PR mergée en 30 j
Description
I am trying to use Abstract Base Classes. But I find the documentation lacking on several points that makes the matter too 'abstract'.
For example. There is no explanation on making abstract objects mandatory by using exceptions
Or how to implement Iterable abstract bsse class that can be inherited from and still be usable.
Can someone shed more light onto this so that the documentation is more accessible?
Guide de contribution
Aucun guide de contribution indexé pour ce dépôt
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
Commencez par localiser la documentation de Abstract Base Classes et examiner sa couverture actuelle des objets abstraits, des exceptions et de l’héritage d’Iterable. La tâche est terminée lorsque la documentation explique clairement les modes d’utilisation demandés et rende les exemples accessibles aux lecteurs ; aucun fichier ni test spécifique n’est mentionné dans l’issue.
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é
- 4/5
- Temps estimé
- 3-5 jours
- Activité
- À l'abandon
- Clarté
- À clarifier
- Accessibilité débutants
- 35/100