Adjust external API methods
On the interface methods for external API (jira, gitlab etc.), adjust it so that it only takes in the arguments it needs. So for example, if a method needs a struct Project as defined below:
struct {
ID int `json:"id"`
Name string `json:"name"`
}
and we have an interface method say GetBranches(*Project)
. It would confuse the developers if it takes in a whole project pointer since they would think they also need to pass in name parameter of the object when it only needs id. So, we would need to change the method signature to be GetBranches(projectID uint)
.