Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

dunder methods missing from readthedocs API

Aperta
#394 1 commento 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
35/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Ferma
Stack tecnologico
python
Ambito
documentation

Direzione di ricerca

Inizia individuando la configurazione dell’API di Sphinx o Read the Docs per AreaDefinition. Verifica come vengono gestiti metodi speciali come contains, eq e getitem, quindi verifica la documentazione online dell’API generata. Il lavoro è completato quando questi metodi rilevanti per gli utenti sono documentati per AreaDefinition.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

documentation

The AreaDefinition methods support several special methods, for which documentation is missing on readthedocs. The most relevant ones for the user are __contains__, __eq__, and __getitem__.

I think there's a sphinx setting to control whether those are generated with API docs or not.

Problem description

Most users get their documentation from readthedocs. From the API documentation, one wouldn't it's possible (or should be) to check if a certain lat/lon is contained inside an area definition, despite this feature being potentially quite useful.

Versions of Python, package at hand and relevant dependencies

Current pyresample / online docs.

Lingua principale
Python
Stelle
388
Fork
102
Merge medio
5g 17h
PR unite (30g)
5

Preparare l'ambiente

  • Nessun Dockerfile né file Docker Compose
  • Ha un modello di pull request
  • Nessuna guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di pytroll/pyresample

Tutte le issue di pytroll/pyresample

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.