Skip to content
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

Document what renovate.json is for #116

Closed
Svish opened this issue Nov 27, 2022 · 5 comments
Closed

Document what renovate.json is for #116

Svish opened this issue Nov 27, 2022 · 5 comments
Labels
docs Improvements or additions to documentation

Comments

@Svish
Copy link

Svish commented Nov 27, 2022

Created a new project using this starter, and I find this renovate.json file in it, but I don't see any explanation of why it's here, what it's for, or how to use it.

{
  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
  "extends": [
    "github>sanity-io/renovate-presets//ecosystem/auto",
    "github>sanity-io/renovate-presets//ecosystem/studio-v3"
  ]
}

What does it do? Should it be deleted in my project? Or does it have value to me? If so, how? Do I need to set something up for it to "do anything"?

@stipsan
Copy link
Member

stipsan commented Nov 28, 2022

Hey, we use it to get PRs for dependency updates 🙂 If you don't install it first, then this file does nothing.
If you do have it installed, then you'll see it open an issue like this that keeps you posted on the status of your dependencies. And PRs that helps keep you up to date on npm packages like sanity, next-sanity and more.

@stipsan
Copy link
Member

stipsan commented Nov 28, 2022

Here's an example PR: #112

@Svish
Copy link
Author

Svish commented Nov 28, 2022

Cool, need to check that out, could be useful for other projects too.

Would still like to encourage you guys to document that somehow in the starter though. Understanding the bits and pieces that are pulled in via a starter is crucial to not feel overwhelmed and confused.

In this case, it should be some short documentation of what Renovate is, that it's safe to delete the file if you don't want to use it, and what in the world this actually does:

  "extends": [
    "github>sanity-io/renovate-presets//ecosystem/auto",
    "github>sanity-io/renovate-presets//ecosystem/studio-v3"
  ]

@stipsan stipsan added the docs Improvements or additions to documentation label Nov 28, 2022
@stipsan
Copy link
Member

stipsan commented Nov 28, 2022

Yup great suggestion @Svish, adding to the backlog 👍

@stipsan
Copy link
Member

stipsan commented Nov 28, 2022

For now, there's more information on the preset we're using here: https://github.com/sanity-io/renovate-presets/tree/main/ecosystem#readme

  "extends": [
    "github>sanity-io/renovate-presets//ecosystem/auto",
    "github>sanity-io/renovate-presets//ecosystem/studio-v3"
  ]

This loads two presets:

In these presets we try to fill out description fields for each rule to explain what they are and what they do ☺️

@stipsan stipsan closed this as completed Jun 30, 2023
@github-actions github-actions bot locked as resolved and limited conversation to collaborators Aug 10, 2023
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
docs Improvements or additions to documentation
Projects
None yet
Development

No branches or pull requests

2 participants