Next

[matthewshaver]

What are you changing in this pull request and why?

Merge current into next

Checklist

• Review the Content style guide so my content adheres to these guidelines.
• For docs versioning, review how to version a whole page and version a block of content.
• Add a checklist item for anything that needs to happen before this PR is merged, such as "needs technical review" or "change base branch."

Adding or removing pages (delete if not applicable):

• Add/remove page in website/sidebars.js
• Provide a unique filename for new pages
• Add an entry for deleted pages in website/vercel.json
• Run link testing locally with npm run build to update the links that point to deleted pages

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
docs-getdbt-com	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Apr 26, 2024 6:55pm

[mirnawong1]

hey @matthewshaver , great job and thanks so much for consolidating this! I've got some feedback on the layout:

• structure — maybe we can have a more consistent, clean layout that makes it easy to distinguish between different types of updates (new features, enhancements, fixes). i think if we use headers and subheaders, it might allow us to bulk related topics inside the header (e.g. all the 'new' goes under the ## new header, etc. i also wonder if we can consider adding icons or colo to visually separate different sections?
• expandable — maybe we can indent the expandable so its in line with the bullets. currently it's looking all weird. i also wonder if we can have the expendables grouped grouped together so it doesn't interrupt the bullet bullet bullet,etc flow?
• right toc — might be good to have a right toc so users can quickly navigate?
• intro — nice-to-have a more fleshed-out intro sentence?

example

April 2024

What’s new:

• Merge jobs [Beta] - Trigger dbt job runs via Git pull requests....
• Semantic Layer enhancements - Additional support for Privatelink and SSO....

Enhancements:

• Select entities for group by, filter by, and order by in Semantic Layer...,

Fixes:

• Resolved dbt parse error when using list filters.
• Improved join_to_timespine application in metrics.

[mirnawong1]

also adding replicated's docs as inspo: https://docs.replicated.com/release-notes/rn-app-manager

[matthewshaver]

@mirnawong1 Great feedback and good ideas worth considering. We currently have an Asana task open to fix the formatting errors for the lifecycle pills so we can use those in front of the items.

As for the grouping, we need to take into consideration that these will be grouped by week once we go live (based on customer requests for release notes). We've taken the historical data and grouped it by Month but when we go live it will look more like this:

MONTH

WEEK 1

• New: Feature
• Fix: Feature
• Enhancement: Feature

WEEK 2

• New: Feature
• Fix: Feature
• Enhancement: Feature

and so on

Let's bring it to the group when I get back and figure out what we think is the best way to group in that context.

Right TOC - will be adding that, but the automation removes it from that section, so we have to figure out a way to put it back. If you have ideas, I'm open to them.

Intro - it's a pretty straightforward section, so I kept it simple, but I'm open to any additional language you think would be good.

Expandables - I'll try the indenting and see what that looks like now! Great idea. I also have an Asana task in to get those to support markdown formatting in the title

[runleonarun]

@matthewshaver small suggestion for right ToC

[runleonarun]

@matthewshaver If you change these to an H2 they show up in the right hand TOC!

Suggested change

	# April 2024
	## April 2024

[runleonarun]

@mirnawong1 and @matthewshaver I added some thoughts about layout in the follow-up issue

Quick question: when will we remove the old jan through April folders and add redirects?

[matthewshaver]

@mirnawong1 and @matthewshaver I added some thoughts about layout in the follow-up issue

Quick question: when will we remove the old jan through April folders and add redirects?

Yup! I'll work on it when I get back!