Skip to content

Conversation

@pepicrft
Copy link
Contributor

We are going to start publishing case studies of customers so existing users or teams interested in Tuist don't have to take our word for the impact that our solutions have.

@pepicrft pepicrft requested a review from a team December 18, 2025 16:43
@pepicrft pepicrft self-assigned this Dec 18, 2025
@pepicrft pepicrft requested review from cschmatzler and fortmarek and removed request for a team December 18, 2025 16:43
@dosubot dosubot bot added the size:XXL This PR changes 1000+ lines, ignoring generated files. label Dec 18, 2025
@dosubot
Copy link

dosubot bot commented Dec 18, 2025

Related Documentation

Checked 1 published document(s) in 1 knowledge base(s). No updates required.

How did I do? Any feedback?  Join Discord

@dosubot dosubot bot added the type:enhancement New feature or request label Dec 18, 2025
Copy link
Member

@fortmarek fortmarek left a comment

Choose a reason for hiding this comment

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

👏

I've also noticed we have "Case studies" in the "Blog" but the new posts don't appear there. Also, the category has, for whatever reason a hyphen there:
image

I know it's in the design, but I find the "What monday.com does..." too off center. For the time being, I'd consider skipping it, I don't think having that title is needed and we can reconsider it once @asmitbm is back:
image

I find the title too long. Should we have a short title and with a subtitle like regular blog posts?
image

Additionally, have we thought about putting the case study more front-and-center in the landing page, such as by making the customers section be a link to case studies?

margin-block-end: 0;
}

.sr-only {
Copy link
Member

Choose a reason for hiding this comment

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

I find this class name confusing. What is it for?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I Claude making the case study page more accessible, and suggested using that class in a [link](https://github.com/tuist/tuist/pull/8956/changes#diff-73a995584be83adf5660e8a991f2bc76e798e28308c434cf59960252bc1cb2d0R410 in the case studies page to indicate screen readers that the link opens in a new tab.

I'm not too opinionated about it, so I'm also fine with removing it.

Comment on lines 452 to 470
def case_studies_rss(conn, _params) do
cases = CaseStudies.get_cases()
last_build_date = cases |> List.first() |> Map.get(:date)

conn
|> assign(:cases, cases)
|> assign(:last_build_date, last_build_date)
|> render(:case_studies_rss, layout: false)
end

def case_studies_atom(conn, _params) do
cases = CaseStudies.get_cases()
last_build_date = cases |> List.first() |> Map.get(:date)

conn
|> assign(:cases, cases)
|> assign(:last_build_date, last_build_date)
|> render(:case_studies_atom, layout: false)
end
Copy link
Member

Choose a reason for hiding this comment

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

I don't know if we want to have another RSS for case studies. Case studies are basically special pieces of blog posts and I think we should try to model them more like that.

Copy link
Contributor Author

@pepicrft pepicrft Dec 19, 2025

Choose a reason for hiding this comment

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

Could you expand on what modeling them like blog posts means to you? Is it that they should show up in the RSS & Atom of the blog?

Copy link
Member

Choose a reason for hiding this comment

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

Is it that they should show up in the RSS & Atom of the blog?

That and I would expect them to show up in the blog page as well: https://tuist.dev/blog

@pepicrft
Copy link
Contributor Author

pepicrft commented Dec 19, 2025

I've also noticed we have "Case studies" in the "Blog" but the new posts don't appear there. Also, the category has, for whatever reason a hyphen there:

I suggest we move this one to case studies once we have an open-graph card design for it. I can follow-up with Trendyol with suggestion to align it with the structure we'd like case studies to have.

I know it's in the design, but I find the "What monday.com does..." too off center. For the time being, I'd consider skipping it, I don't think having that title is needed and we can reconsider it once @asmitbm is back:

I'll skip it then.

I find the title too long. Should we have a short title and with a subtitle like regular blog posts?

I can shorten the title. Regarding the subtitle, I'm fine with that. We have a excerpt that we use in the HTML for SEO, so we can reuse it. I suggest that we ship the design as it is, and tackle these improvements once @asmitbm is back and can help us iterate on the design.

Additionally, have we thought about putting the case study more front-and-center in the landing page, such as by making the customers section be a link to case studies?

Same here. I'll capture this in a task for @asmitbm to design when he's back.

Copy link
Member

@fortmarek fortmarek left a comment

Choose a reason for hiding this comment

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

The case studies header is missing a CTA ("Talk to us"):
image

Otherwise, looks good!

use NimblePublisher,
build: Tuist.Marketing.CaseStudies.CaseStudy,
from: Application.app_dir(:tuist, "priv/marketing/case_studies/*.md"),
as: :cases,
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
as: :cases,
as: :case_studies,

would probably rename this and the get_cases method to get_case_studies

@dosubot dosubot bot added the lgtm This PR has been approved by a maintainer label Dec 19, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

lgtm This PR has been approved by a maintainer size:XXL This PR changes 1000+ lines, ignoring generated files. type:enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants