Skip to content

Packaging: Split pages to reduce duplication and new recipe creation page#72

Merged
NomadicCore merged 3 commits intomainfrom
new-recipe
Jan 26, 2026
Merged

Packaging: Split pages to reduce duplication and new recipe creation page#72
NomadicCore merged 3 commits intomainfrom
new-recipe

Conversation

@NomadicCore
Copy link
Copy Markdown
Contributor

@NomadicCore NomadicCore commented Jan 24, 2026

CookieSource created a draft page for creating a new recipe. Uploading as a draft so we can collaboratively refine

To-Do:

  • Check structure and language against "Updating an existing package recipe"
  • Answer comments and questions raised
  • Remove drafting notes

CookieSource created a draft page for creating a new recipe. Uploading
as a draft so we can colaboratively refine

To-Do:
- Check structure and language against "Updating an existing package
  recipe"
- Answer comments and questions raised
- Remove drafting notes
Updated the complete packaging workflow with the addition of a new
"Creating a new package recipe" page and then splitting out additional
copy into separate pages so copy isn't duplicated across Creating and
Updating package recipe pages

- New "Preparing for packaging" page
- New "Creating a new package recipe" page
- New "Building and testing packages" page
- New "Checking for package updates" page
- Updated "Updating a package recipe" page

**Testing**

- Built dotdev locally and ensured site was wroking, particularly given
  the new pages added
@NomadicCore NomadicCore marked this pull request as ready for review January 25, 2026 14:25
@NomadicCore
Copy link
Copy Markdown
Contributor Author

Hey all,

I've worked on this based on @CookieSource previous efforts. I have reworked most of the packaging workflow to separate out additional pages where steps are repeated between "Creating a new package recipe" and "Updating an existing package recipe".

One thing I note is using boulder recipe new, is that it doesn't catch:

builddeps :
- binary(msgfmt)

as a requirement. @CookieSource didn't catch this in her reproduction so I'm wondering if I could get guidance on how / where we would identify this? I ask as I built the package without that binary as part of this package creation process and it built and worked fine as far as I could see so I don't think a user would pick this up?

@CookieSource
Copy link
Copy Markdown
Member

So I think the detailed guide already shows someone to go to the website of the creator of a package and reading that documentation simply is always going to be a requirement over any automatic creation. I would say this helps as a starting point so you have a template you can modify based on upstream documentation and dependencies/optional dependencies it's nothing more than that in my eyes.

@NomadicCore NomadicCore changed the title NewRecipe: Draft page from CookieSource for creating a new recipe Packaging: Split pages to reduce duplication and new recipe creation page Jan 25, 2026
@CookieSource
Copy link
Copy Markdown
Member

Looks good to me.!

@NomadicCore NomadicCore merged commit 115e16c into main Jan 26, 2026
1 check passed
@CookieSource CookieSource deleted the new-recipe branch January 26, 2026 08:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants