Skip to content

Improve monorepository getting started documentation#1487

Open
Krusty93 wants to merge 14 commits intomainfrom
CES-1691-aggiornare-pagina-documentazione-dx-init
Open

Improve monorepository getting started documentation#1487
Krusty93 wants to merge 14 commits intomainfrom
CES-1691-aggiornare-pagina-documentazione-dx-init

Conversation

@Krusty93
Copy link
Copy Markdown
Contributor

@Krusty93 Krusty93 commented Mar 25, 2026

Resolves CES-1691, CES-1816

@changeset-bot
Copy link
Copy Markdown

changeset-bot bot commented Mar 25, 2026

🦋 Changeset detected

Latest commit: 96d243e

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
docs Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@Krusty93 Krusty93 marked this pull request as ready for review March 25, 2026 10:10
@Krusty93 Krusty93 requested a review from a team as a code owner March 25, 2026 10:10
Copilot AI review requested due to automatic review settings March 25, 2026 10:10
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Updates the “getting started” documentation to center the monorepo bootstrap flow around npx @pagopa/dx-cli init, including prerequisites, GitHub App preparation, and the post-generation infrastructure steps.

Changes:

  • Rewrote monorepo setup guide to follow the dx init end-to-end workflow (GitHub App prep → init → infra apply → repository registration).
  • Expanded DX CLI docs with a prerequisites section and a detailed init prompt reference.
  • Removed the standalone GitHub PAT setup page and added a changeset for the docs package.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 6 comments.

File Description
apps/website/docs/monorepository-setup.md Reframes the monorepo setup as a dx init-driven process and adds post-init operational steps.
apps/website/docs/dx-cli/index.md Adds explicit requirements and a prompt-by-prompt reference for dx init.
apps/website/docs/dx-cli/github-pat.md Removes the PAT setup doc page.
.changeset/kind-pillows-trade.md Publishes the documentation updates as a patch release for the docs package.

Copy link
Copy Markdown
Member

@lucacavallaro lucacavallaro left a comment

Choose a reason for hiding this comment

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

I would split the steps in two different sections, based on target audience

  • Developers (dx-cli init for an existing product)
  • Engineering Leader (github app, initialization, apply of the core module)

@pagopa pagopa deleted a comment from Copilot AI Mar 26, 2026
@Krusty93 Krusty93 force-pushed the CES-1691-aggiornare-pagina-documentazione-dx-init branch from 951e8aa to 64deaf2 Compare March 27, 2026 10:31
@gunzip
Copy link
Copy Markdown
Contributor

gunzip commented Mar 27, 2026

it looks like formatting checks fail

@Krusty93
Copy link
Copy Markdown
Contributor Author

I would split the steps in two different sections, based on target audience

  • Developers (dx-cli init for an existing product)
  • Engineering Leader (github app, initialization, apply of the core module)

Done!

@Krusty93 Krusty93 force-pushed the CES-1691-aggiornare-pagina-documentazione-dx-init branch 2 times, most recently from 4265223 to 11d505e Compare March 27, 2026 13:56
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated 5 comments.

@Krusty93 Krusty93 force-pushed the CES-1691-aggiornare-pagina-documentazione-dx-init branch from f68b9e1 to bba9a64 Compare March 31, 2026 08:05
@Krusty93 Krusty93 force-pushed the CES-1691-aggiornare-pagina-documentazione-dx-init branch from bba9a64 to 96d243e Compare April 1, 2026 08:23
@Krusty93 Krusty93 requested review from lucacavallaro and mamu0 April 1, 2026 08:27
@kin0992 kin0992 force-pushed the CES-1691-aggiornare-pagina-documentazione-dx-init branch from 96d243e to 70cf2f3 Compare April 1, 2026 15:04
@Krusty93 Krusty93 force-pushed the CES-1691-aggiornare-pagina-documentazione-dx-init branch from 70cf2f3 to 849c5fc Compare April 1, 2026 15:22
Confirm the migration when prompted.

### Step 2 — Apply `infra/core` (if present)

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

suggestion: I'd add a brief description about what this apply does

</Tabs>

### Step 3 — Verify and apply `infra/bootstrapper`

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

suggestion: I'd add a brief description about what this apply does

@Krusty93 Krusty93 force-pushed the CES-1691-aggiornare-pagina-documentazione-dx-init branch from 849c5fc to 4cb70c5 Compare April 3, 2026 08:45
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 3, 2026

Azure Static Web Apps: Your stage site is ready! Visit it here: https://proud-mud-0405c6703-1487.westeurope.1.azurestaticapps.net

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.

6 participants