• 0 Posts
  • 8 Comments
Joined 2 years ago
cake
Cake day: June 8th, 2023

help-circle


  • Even as an embedded C developer I use “idx” and “count” instead of “i”. Not just because I’m a member of the “slightly longer but more descriptive names are better” gang, but also for searchability. If I’m trying to track down where an array is accessed in a loop, for example, “idx” is more likely to take me only to the results I’m looking for and not also the “i” in int8_t or whatever.


  • Shit, Microsoft docs are better than most other large companies with broadly used software even, not just random undocumented BS from smaller companies and products. In my experience, Microsoft’s Xamarin docs are somehow often a better guide for Android development than Google’s docs (good god are the official Android docs some of the hottest garbage that a company of Google’s size and talent could put out), and I’ve yet to find a better general reference for any language or library than Microsoft’s .NET documentation. I’ve seen a lot of people dunk on it for it’s verbosity and/or “example bloat” but I love the length of their docs for breaking down different use-cases and giving examples of each, along with potential misuses and recommended alternatives.

    That said, they do still have some garbage docs (like what OP is pointing out), but my general experience with their docs, especially for their larger/more mainstream products, has been surprisingly positive.