Skip to main content

Can Pull Requests Talk? Effective Communication Within Developers - An Idea

Majorly, I still love writing code. Do you know why? Because code expresses your intelligence in words that can be processed. And also, it helps others understand what you are trying to communicate in a better way. I believe that writing code is a way of communication and it enables developers understand better than just talking about the concepts or logic in plain english words.

This is the thought process that leads to my today's post.

I came across a situation recently when a Pull Request represented an idea but not an actual implementation. The idea was expressed not in a google document but in a couple of lines, which inherently changes the way the software would work. It meant a big change, but in reality it was not a PR that *has* to be merged, but just something can be written to help others understand what changes it incurs. Mind you, its not a 1000 line change. It was a couple of double-digit line changes.

I would appreciate the developer's smartness in writing the code and then talking about it because it would help the team talk about an approach instead of just drawing pictures on the whiteboard and writing endless documentation. This was the outcome of the exercise - the team understood what they are up against and what are the other changes that they have to solve before attempting the problem. 

I think that the above approach also helps implement the agile principle of
Working software over comprehensive documentation

I see the following advantages to it
  1. Crisp idea of what needs to be changed
  2. Will initiate a whole discussion in the team about the impacts and what the change entails
  3. It's easier for team to see PR changes via github (for example) and discuss
  4. It's a passive mode of finding the discussion points
  5. Distributed teams can work really well in this mode.
Let me your thoughts in the comments section.

Follow me on Twitter, Facebook, LinkedIn, Instagram or Website.



Installation of rvm erroring out in Catalina - Ruby 2.3.x - How to solve them?

If you had recently updated your macOS to Catalina and then faced problem with installing certain versions of ruby because of random error, pls try the following.
If you are getting the following error, while doing a rvm install
Error running '__rvm_make -j8',
Try the following:
Possiblility is that because of openssl 1.1. OpenSSL 1.1 is not compatible with the ruby compilation during the rvm install.
First install openssl 1.0 using macports
$ sudo port install openssl10
Now install (reinstall) the ruby using rvm with openssl pointing to the macports version
$ PKG_CONFIG_PATH=/opt/local/lib/openssl-1.0/pkgconfig rvm reinstall 2.3.7 --with-openssl-lib=/opt/local/lib/openssl-1.0 --with-openssl-include=/opt/local/include/openssl-1.0
Just ensure that the openssl from macports is installed into /opt/local/lib/openssl-1.0
Hope this helps.
Talk to me on TwitterFacebookLinkedIn or Website