• 0 Posts
  • 306 Comments
Joined 1 year ago
cake
Cake day: June 21st, 2023

help-circle
  • Types aren’t unit tests. Unit tests only test a discrete set of inputs and outputs for correctness, and can miss cases that aren’t tested for.

    In sound type systems, they are closer to formal verification. The compiler guarantees the properties you expect of the type hold.

    As for the rest of the article, do what works best for you in your projects, but if I need to work with you, I’m going to ask for types. I need to know what types the interface expects to receive. Names are not enough. Document them, use type hints, whatever, just put them somewhere because I’m not psychic and I don’t know what you thought about when writing the function.


















  • Sometimes when I don’t leave comments like that, I get review comments asking what the line does. Code like ThisMethodInitsTheService() with comments like “what does this do?” in the review.

    So now I comment a lot. Apparently reading code is hard for some people, even code that tells you exactly what it does in very simple terms.


  • TL;DR:

    From today the license applied to the project will be the Apache 2.0 license with an extra line forbidding usage of the codebase as an integration or app to Atlassian’s Confluence or Jira products.

    While it’s disappointing to see the additional restriction, it’s better to have a project the devs find sustainable than to have nothing at all. It seems like the goal of this change is to protect their main source of funding.

    Worst case, people can fork the code before the change.