Skip to content

build: freshness #23172

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 11 commits into
base: main
Choose a base branch
from
Open

build: freshness #23172

wants to merge 11 commits into from

Conversation

ArthurFlag
Copy link
Contributor

Apply various linguistic efficiency improvements.

@ArthurFlag ArthurFlag requested a review from crazy-max as a code owner July 28, 2025 12:49
Copy link

netlify bot commented Jul 28, 2025

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit a545298
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/688797546f97e1000859b175
😎 Deploy Preview https://deploy-preview-23172--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions github-actions bot added area/build Relates to Dockerfiles or docker build command area/release Relates to CI or deployment labels Jul 28, 2025
Copy link
Member

@crazy-max crazy-max left a comment

Choose a reason for hiding this comment

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

Didn't finish reviewing yet, but I noticed a few places where the text seems to take shortcuts that subtly change the meaning of core concepts or lose important nuance. For pages like concepts, which are relied on for precision (especially by folks deep in the ecosystem) it's really important to preserve the intent and technical accuracy of the original terms.

Also, looking at the freshness prompt files, I'm guessing this might have been generated with the help of an AI assistant? If so, it'd be helpful to split AI-generated changes and your own edits into separate commits, so it's easier to see where the AI may have gone off track.

@ArthurFlag
Copy link
Contributor Author

It's indeed mostly AI-touched up to see how it runs our styleguide on the content. Maybe that's a bit of waste of time (and review time) for the outcome. I'm not super convinced with this initiative.

@crazy-max
Copy link
Member

It's indeed mostly AI-touched up to see how it runs our styleguide on the content. Maybe that's a bit of waste of time (and review time) for the outcome. I'm not super convinced with this initiative.

Yes me too but that's good to test it out and maybe improve the model and prompts if we can.

@ArthurFlag ArthurFlag requested a review from crazy-max July 29, 2025 07:38
@ArthurFlag
Copy link
Contributor Author

@crazy-max, any chance you could take another look this week? 🙇

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/build Relates to Dockerfiles or docker build command area/release Relates to CI or deployment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants