For every star on GitHub, we'll donate $2 to clean up our waterways. Star us now!

Team Practices

This page defines recurring practices which help the Engineering team to function effectively and efficiently.

Weekly and Fortnightly Rituals

Weekly Iterations

We adhere to a weekly iteration delivery cycle. We do not adhere to formal sprints. Instead, leadership from Engineering and Product meet each Thursday to discuss the upcoming priorities for the next two weeks and to add or update the following week’s tasks. An “iteration” is simply a bucket of issues in GitHub which are assigned for work over a given week.

We generally work with more of a kanban style. We do this as it works better with our committment to asynchronous work. We aim to minimize Work in Progress (WIP) which, for Meltano, means assigned work in a given iteration.

Engineers are expected to deliver at least one feature or bug fix at least every 3 out of 4 weeks.

Mid-Week Virtual Standup

Every Wednesday, engineers receive an automated prompt from Geekbot in Slack, requesting a summary of work in-flight and expected deliverables through the end of week (EOW). This should be completed by end of day (EOD) Wednesday, as this information will be used on Thursday in planning the deliverables for the following week.

Weekly Product:Engineering Leadership Sync

On a weekly basis (generally Thursdays), Engineering and Product leadership meet with the following agenda:

  • review any takeaways from engineers’ virtual standup status
  • review progress against published roadmap items, discuss slippage and needed realignment if applicable
  • discuss prioritization of large work items - those already in the roadmap and any needing to be added into the roadmap
  • prepare Engineering assignments for the upcoming week’s milestone
  • ping engineers on Slack for any needed follow-up

During the process of creating engineering assignments for the coming week, Product and Engineering leadership will take care that each engineer is assigned at least one small or medium-sized work item (<=4 weight) in addition to any larger long-running work items. This is to that ensure every engineer has the ability to ship at least one work item in the coming week, per the Engineering team’s standard practice - and that at any time if an engineer becomes blocked on a larger work item (waiting for code review feedback, for instance), they can immediately fall back to the smaller item as needed.

Weekly Office Hours

Every Wednesday, the Meltano team meets with our users and community members. The main objectives of this meeting are:

  1. To gain outside perspective on product direction. Feedback can corroborate our direction and intuitions, but it can also show us perspectives which we may not yet have considered.
  2. To share internal deliberations with the community. The goal here is to spread awareness while gaining benefit of insight from external perspectives.
  3. To hear directly and “face to face” from community members on topics they care about. We invite every Meltano community member to openly share any pressing topics or questions they might have.

Sourcing Contributors

  • Within the week or two leading up to the office hours, look out for at least one or two community members and corresponding topics which can benefit from synchronous communication.
  • Prep a list of contributor names so we can call them out during the session as time allows. (Use a dedicated slide with their names or aliases if warranted.)
  • Timebox rotating topics and set expectations ahead of time in the slides: e.g. 15 minutes for dedicated topic, 45 minutes for questions, debugging, AMA, etc.

Best Practices

  • When discussions are in progress, drop the screenshare in order to give participants more face time.
  • Be aware that the owner’s view layout (gallery or otherwise) also changes the view for others.
  • Share any relevant links in the zoom chat.

Office Hours Planning

During the weekly Thursday sync between Engineering and Product leadership (@aj and @taylor), Product and Engineering leadership will perform the following maintenance:

  1. Move those topics on the Office Hours board in GitHub into the “Discussed” column, effectively resetting the “Up Next” list for the upcoming week.
  2. For any upcoming, in-progress, or recently released features that need discussion or refinement:
    1. Move into Up Next on the Office Hours board in GitHub.
    2. Tag an engineer or another team member on the issue, requesting grooming of the description - or any other needed prep, per the engineer’s discretion.

If fewer than 3 topics are selected as candidates for discussion in the upcoming week, and/or if one or more topics require community member attendance, then Engineering or Product leadership will raise these concerns as new threads in the #office-hours-planning channel.

Office Hours Content Escalations

Our goal is to have 3 medium-sized topics for each office hours, roughly 30-45 minutes of internally-curated content in order to make the most of our attendees’ valuable time.

In cases where there is an expected shortage of Office Hours content, reach out to community members who have raised topics or opened MRs with us recently. Especially relevant are contributors who have proposed net-new functionality, including new plugins, new capabilities, and other feature improvements which are relevant for team discussion. Community members with long-running or outstanding MRs also make good invitees, in hopes that a face-to-face conversation could unblock or otherwise assist the contributor’s MR to progress forward.

We will not cancel Office Hours sessions for lack of content, but may opt to conclude the session early, any time after 10 minutes elapsed. Sessions will always be held open for 10 minutes minimum, to allow time for community members to join and offer proposed topics or questions.