Ask HN: How does your team architect and push code?
We have issue templates for features, bugs, and incidents to help everyone write the best issue they can. Here&#x27;s a feature template verbatim (just removed a few details, not changed):<p><pre><code>  &lt;!--These are comments and will not be rendered. Please click Preview to check.--&gt;
  
  ### Summary
  &lt;!--Summarize the feature in one or two sentences. This is a TL;DR.--&gt;
  
  
  
  ### Description
  ----------------
  
  &lt;!--Describe the problem we&#x27;ll solve. What, where, when, who, why, and how.--&gt;
  
  
  ### Target
  ----------
  &lt;!--Who&#x27;s the target audience? Who&#x27;ll enjoy this the most or suffering from
      lacking this feature the most? Is this a problem you have? Have you talked
      with other people who have this problem? Is it something that would just be cool?
      Is it a seed for an idea that can be cool?
  --&gt;
  
  
  
  ### Instances
  -------------
  
  &lt;!--If the problem has happened multiple times, can you describe them--&gt;
  
  
  ### Proposal
  ------------
  
  &lt;!--What is the plan to solve this problem? Can we guess a solution or have a hunch?
      Do we have a list of steps? It&#x27;s okay if they are a bit vague for now. We&#x27;ll clarify
      by debating them and adding context to them, reading more about the subject. It&#x27;s 
      essential to understand that this document serves to capture thoughts and externalize
      thought processes so we can all tackle the problem more effectively.
  --&gt;
  
  
  ### Resources
  -------------
  
  &lt;!--Do you recommend any reading to do about this? Maybe a video to watch for something similar?
      Maybe a blog post or documentation pages or just a snippet? An image, mock-ups, etc...
  --&gt;
  
  
  
  
  &#x2F;label ~feature
  &#x2F;cc @jhadjar


</code></pre>
Everyone writes issues and is expected to write issues whenever they encounter a bug or think of a feature or proposes an idea. We do a brain dump as soon as possible to written form, so that others who are not there may stay informed, and <i>we</i> don&#x27;t lose the context and progress if we only do it a couple of months later. The issues and the comments capture the research, the findings, the objections, the resources, the conversation. We cross link to a Slack conversation sometimes, and often copy the relevant comment and answer those.<p>Now we have issues in our backlog. Based on our roadmap, what conversations we&#x27;re having and how they fit into that roadmap, what we want (or <i>do not want</i>) the product to be in a few years, in a few months, in a month, in a week, we&#x27;ll have conversations.<p>The most pressing issues will surface. Our product has a collaborative notebook feature, and we use it to have a collaborative notebook that contains the issues we want to talk about in the upcoming call for the product itself (I love that self reference). We go over them one by one, add remarks, sometimes add snippets of code, add action items, add rationale (why this is not important, why this must be done, why this will be postponed, why this needs to come after that, why do we not care about this), add impact on other parts to sort out, or whether we need to open an issue on a third-party tool&#x2F;library&#x27;s issue tracker.<p>Then after debating pretty much everything and objections have been cleared, the next steps and next issues are clear for everyone. Everyone knows what they should do: &quot;OK, I&#x27;ll take care of this, this, and then this. I&#x27;ll need your help for that one, but I&#x27;ll tell you when I get there&quot;.<p>Everyone takes the issues they want to do, because they mostly end up owning parts of the product that are stitched together to form a flow. There&#x27;s a large overlap and everyone understands other parts, but people tend to truly be fast on parts they completely own and continue to refine them: bug, improvement, functionality, and the entire &quot;flow&quot; of the thing from end to end.<p>We exchange about the general implementation in the issue, but there&#x27;s a huge autonomy and I sometimes will object to specific approaches or specific implementation ideas rather than validate. The team is good and right most of the time, so I only intervene on the 5% rather than spend time green-lighting 95% which would be a waste of time, energy, and create bottlenecks.<p>Sometimes the <i>code</i> in a merge-request&#x2F;pull-request does not match the description, or introduced something (for example, it will leak an abstraction or introduce an external dependency on something we <i>precisely</i> want to stay stripped down), we&#x27;ll talk about that and the implementation changes. In other words, sometimes you catch something downstream even though you have that conversation, issues, comments, talk.<p>We don&#x27;t develop &quot;to spec&quot; for parts that don&#x27;t require them (inter-machine? if there&#x27;s a contraint, we&#x27;ll just say S3 compatible, that&#x27;s the spec). When I write an issue, I&#x27;ll write and describe the problem, the job to be done, and the &quot;Instances&quot; of that problem happening (to whom, when, how many times, what impact and frequency). We ruthlessly prioritize. We&#x27;re not Don Quixote. I may include an initial possible solution or implementation, but I <i>will make it clear explicitly in writing that this is one implementation and that issue is a draft, and the code is a proof-of-concept, and will ask for others&#x27; thoughts</i>. We focus on the problem, and we explore several solutions in the issue. Pros and cons, impact on other parts for each one.<p>We don&#x27;t come up with the whole design and a formal specification before writing code. It&#x27;s a waste of time at this stage. Just landmarks for navigation, and a few caveats for pitfalls (for example, beware zipbombs if you&#x27;re doing something with zip files).<p>I read pull requests, see the changes (that allows you to catch things like the above), test them, interact with them, ask questions, make suggestions, then when it&#x27;s all resolved, I merge them. Most of the time, they&#x27;re already good to go.<p>I&#x27;m not writing code as often as I&#x27;d like to, but when I rarely do, it goes through the team&#x27;s eyeballs in case I screwed something up.<p>Then someone from the team deploys to production, or I do. If there&#x27;s a manual step in the process, there&#x27;s someone whose area of the product is responsible for that who&#x27;ll do it. Say we need to push a Docker image when we merge something, then my colleague (who resolved the issue and whose pull request I just merged) will push that image to a registry.