Friendica
James Scholes
James Scholes

James Scholes

jscholes@dragonscave.space

James Scholes

jscholes@dragonscave.space
Digital #Accessibility Engineer/Analyst, #ScreenReader user, and occasional #software developer. #a11y
ActivityPub
2025-12-05 20:52:14 2025-12-05 20:48:22 2025-12-05 19:52:16 9344586

James Scholes
James Scholes
mastodon - Link to source

James Scholes

1 week ago • •

James Scholes

1 week ago • •


Dear #Python Developer,

The single sentence, "The interface is like #JavaScript WebSocket object," does not constitute acceptable documentation in the context of a Python project.

Yours,

Annoyed.

#python #javascript
  •  Languages
  •  Search Text
  •  Share via ...

reshared this

André Polykanine reshared this.

in reply to James Scholes

miki
mastodon - Link to source

miki

in reply to James Scholes • 1 week ago • •

Python docs are really all over the place.

I've seen everything from just readme.md, to reference documentation embedded in tutorials (and sometimes omitted when there was no good place for it), to separate tutorials and reference docs, to docs explaining what an env var is, but not how to do what you actually want to do.

  •  Languages
  •  Search Text
  •  Share via ...
⇧