Skip to content

Refactor + resolve & persist docs errors#175

Open
fivetran-avinash wants to merge 5 commits intomainfrom
refactor/resolve-persist-docs-errors
Open

Refactor + resolve & persist docs errors#175
fivetran-avinash wants to merge 5 commits intomainfrom
refactor/resolve-persist-docs-errors

Conversation

@fivetran-avinash
Copy link
Contributor

@fivetran-avinash fivetran-avinash commented Mar 11, 2026

PR Overview

Package version introduced in this PR:

  • v1.7.0

This PR addresses the following Issue/Feature(s):

  • GA-1017798

Summary of changes:

  • Resolve persist docs errors, remove story points, story point estimate and teams from docs and story points/story point estimate as default fields

Submission Checklist

  • Alignment meeting with the reviewer (if needed)
    • Timeline and validation requirements discussed
  • Provide validation details:
    • Validation Steps: Check for unintentional effects (e.g., add/run consistency & integrity tests)
    • Testing Instructions: Confirm the change addresses the issue(s)
    • Focus Areas: Complex logic or queries that need extra attention
  • [NA] Merge any relevant open PRs into this PR

Changelog

  • Draft changelog for PR
  • Final changelog for release review

@fivetran-avinash fivetran-avinash self-assigned this Mar 11, 2026
@fivetran-avinash fivetran-avinash marked this pull request as ready for review March 11, 2026 23:16
@fivetran-avinash fivetran-avinash added the docs:ready Triggers the docs generator workflow. label Mar 12, 2026
Copy link
Contributor

@fivetran-jamie fivetran-jamie left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great! Couple of in-line questions, plus this:

Should we remove the hard-coded story point logic from the timestamp_issue_field_history model and its intermediate as well? Things work fine with it still in there as it's dynamic, but maybe we want to totally clean it up

Comment on lines +20 to +24
cast(daily_issue_field_history.story_points as {{ dbt.type_numeric() }}) as story_points,
{% endif %}
{% if include_story_point_estimate %}
cast(daily_issue_field_history.story_point_estimate as {{ dbt.type_numeric() }}) as story_point_estimate,
{% endif %}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I see why it's ideal that these fields be numerics, but it makes me a little nervous to cast from string to numeric, at least without doing some cleaning first (that is, unless we can confirm that these values will always be formatted numerically)

Perhaps we'd wanna apply a macro to ensure only numeric characters are included before safely casting? We have a similar macro in Amazon Selling Partner.

Comment on lines +9 to +11
{% set issue_field_history_columns = var('issue_field_history_columns', []) | map('lower') | list %}
{% set include_story_points = 'story points' in issue_field_history_columns %}
{% set include_story_point_estimate = 'story point estimate' in issue_field_history_columns %}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Since this is repeated, I wonder if it's best to do this logic in the model itself and then pass include_story_points and include_story_point_estimate as macro parameters?

select *
select *
from {{ ref('stg_jira__sprint_tmp') }}
where not coalesce(_fivetran_deleted, false)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

could you move this to the end or the final CTE? Just in case anyone doesn't have _fivetran_deleted, the null version would get created in the fields CTE

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs:ready Triggers the docs generator workflow.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants