Found 237 bookmarks
Custom sorting
Ante
Ante
A low-level functional language, for exploring refinement types, lifetime inference, and algebraic effects.
#programming#language
·antelang.org·
Ante
The Documentation Triangle (or, why code isn't self documenting)
The Documentation Triangle (or, why code isn't self documenting)
"My code speaks for itself" is the usual gate-keeper kind of nonsense trotted out by people who just can't be arsed to document their stuff but want to sound like they do it because they are so 1337. This blog post, in not very many words, gives a nice explanation as to why that's rather silly.
#programming
·sourceless.org·
The Documentation Triangle (or, why code isn't self documenting)
Penumbra - colour scheme
Penumbra - colour scheme
Penumbra is a mathematically balanced colour scheme constructed in a perceptually uniform colour space with base colours inspired by the shades of colour occurring in nature due to the light of the sun and the sky. It cleanly separates the perceptual properties of colours while optimally utilizing the available colour space of typical displays.
#design#color#colour#programming#tools
·github.com·
Penumbra - colour scheme
Musings on Python Type Hints
Musings on Python Type Hints
As a huge fan of type hinting in Python, I feel this is a good article introducing the sorts of things you should think about, and the benefits you should derive from using type hints.
#python#programming#blog
·samgeo.codes·
Musings on Python Type Hints
Should You Use Upper Bound Version Constraints?
Should You Use Upper Bound Version Constraints?

I don't agree with much of this, but I recognise it's a valid position. To quote from the TL;DR at the end:

"Capping dependencies has long term negative effects, especially for libraries, and should never be taken lightly. A library is not installed in isolation; it has to live with other libraries in a shared environment. Only add a cap if a dependency is known to be incompatible or there is a high (>75%) chance of it being incompatible in its next release. Do not cap by default - capping dependencies makes your software incompatible with other libraries that also have strict lower limits on dependencies, and limits future fixes. Anyone can fix a missing cap, but users cannot fix an over restrictive cap causing solver errors. It also encourages hiding issues until they become harder to fix, it does not scale to larger systems, it limits your ability to access security and bugfix updates, and some tools (Poetry) force these bad decisions on your downstream users if you make them. Never cap Python, it is fundamentally broken at the moment. Also, even packing capping has negative consequences that can produce unexpected solves."

#python#packaging#pip#semver#programming
·iscinumpy.dev·
Should You Use Upper Bound Version Constraints?
Why (Python) type hinting sucks
Why (Python) type hinting sucks
I don’t agree with the post - type hinting is awesome in my experience - but it’s a cleverly-crafted argument and there’s some interesting debate in the comments.
#python#programming
·reddit.com·
Why (Python) type hinting sucks