Data Science

  • 46 Posts
  • 65 Comments
Joined 1 year ago
cake
Cake day: June 17th, 2023

help-circle







  • This is a great idea!

    Motivation

    The Python docs are ill-suited to novices.

    The content of the built-in functions documentation favors precision and correctness over comprehension for beginners. While this style is great for experienced developers who already understand the finer points of Python’s design, the docs are confusing to novice programmers like a 12 year old who is not far on his journey of learning Python.

    This guide is an opinionated and simplified description of Python’s built-in functions.

    My goal is to provide definitions, in plain English, of each built-in function that comes with Python. Along with each definition is an example that is as simple as I can think of. I ran each example against the latest version of Python as of the time writing this guide.

    I want to be able to share this with my 12 year old son or my 10 year old daughter, so that they can understand and use Python. My hope is that this guide also serves others who would like some plain definitions of what the built-in functions do.

    A note for pedants: I am sacrificing precision and exactness in favor of comprehension. That means I will use substitionary language that I think will communicate more clearly than the exact terminology. If you’re looking for that level of precision, please refer to the standard library docs. Those docs are great for that level of clarity.

    For the rest of us, let’s go!







  • I think making an assumption of hom being “right wing” based on that information is a poor assumption. It’s clear that his behavior has been disruptive, negative, and promoting an unhealthy and unhelpful environment among the community and I think things could have been deescalated. I hope people on the committee aren’t making the bad faith assumption that there’s no way forward other than to excommunicate people who aren’t presently fitting in with the prevalent culture of the community.