• 0 Posts
  • 71 Comments
Joined 7 months ago
cake
Cake day: November 24th, 2023

help-circle






  • Sadly it doesn’t fix the bad documentation problem. I often don’t care that a field is special and either give a string or number. This is fine.

    What is not fine, and which should sentence you to eternal punishment, is to not clearly document it.

    Don’t you love when you publish a crate, have tested it on thousands of returned objects, only for the first issue be “field is sometimes null/other type?”. You really start questioning everything about the API, and sometimes you’d rather parse it as serde::Value and call it a day.



  • I would do that… If CI wouldn’t be set to -D warnings

    Who even does that? Oh wait, it was me.

    Joke aside, it does help to keep the code clean, even more for open source projects where multiple separate people may all have their own codding style, and it helps make it easier to organise.

    But I do agree that it can be really, really annoying.