• 3 Posts
  • 84 Comments
Joined 1 year ago
cake
Cake day: July 2nd, 2023

help-circle










  • Yes true, but people that don’t know what terraform is are probably not the target audience of the beta to initial GA release announcement. The website should make clear what it does for anybody stumbling into the project, and if it doesn’t that should be improved.

    The primary audience here will be people already using or about to use terraform that prefer an open source license and have been waiting for this replacement.








  • There was something like that on Reddit but I can’t remember the sub. I haven’t seen one here. The best way to get reviews of open source is via contributions to larger projects. That of course doesn’t answer your question directly but is worth noting.

    I’d recommend joining some discord or matrix servers for the language you work in or likeminded folk. They tend to have channels for that, and some have really helpful communities.

    eta: I just checked my local instance and saw a community with very few subs and zero posts called /c/reviewmycode. Somebody has to post first.


  • 100%, but my understanding is that most often applies to fields of engineering outside of computer science like mechanical, chemical, structural engineering etc. But there are licensing bodies for achieving Professional Engineer of FE in some cases for CS.

    I am not a lawyer but I presume most laws apply to claims of such certifications rather than job titles. In either case most people don’t pick their own job titles. Just don’t put PE, after your name, same as you should not just randomly throw BSN or MD unless you have a registered licensure.


  • I rarely read comments in code, that is from within source code anyway. I of course write comments explaining the behavior of public facing interfaces and otherwise where they serve to generate documentation, but very rarely otherwise. And I use that generated documentation. So in a roundabout way I do read comments but outside of the code base.

    For instance I might use godoc to get a general idea of components but if I’m in the code I’ll be reading the code instead.

    As others have said, your code generally but not always should clearly express what it does. It is fine to comment why you have decided to implement something in a way that isn’t immediately clear.

    I’m not saying others don’t read comments in code; some do. I just never find myself looking at docs in code. The most important skill I have cultivated over the decades has been learning to read and follow the actual code itself.