Skip to content

Connect cloud doc review#1879

Open
cwickham wants to merge 6 commits intoprereleasefrom
connect-cloud
Open

Connect cloud doc review#1879
cwickham wants to merge 6 commits intoprereleasefrom
connect-cloud

Conversation

@cwickham
Copy link
Collaborator

@cwickham cwickham commented Feb 17, 2026

Changes:

  • Make the structure of the list in the Overview match the headings.
  • Some wording clarifications

I wondered if we should change the order of the publishing providers (in the table on docs/publishing/index.qmd, in the sidebar, and in guide.yml) to demote Quarto Pub - being listed first may mean it's the first place new users land. Is now the right time to do that?

Could we have used the _publish-command.md include for Publish Command section? I think we could have, but I can see why you didn't (e.g. the Posit Connect doc doesn't). Is this something we need to give more direction to Claude on?

@github-actions github-actions bot temporarily deployed to pull request February 17, 2026 21:54 Inactive
@github-actions
Copy link
Contributor

📝 Preview Deployment

🔍 Full site preview: https://deploy-preview-1879.quarto.org

🔄 Modified Documents

@cwickham cwickham requested a review from cderv February 17, 2026 21:55
@cwickham cwickham marked this pull request as ready for review February 17, 2026 21:56
@cderv
Copy link
Collaborator

cderv commented Feb 18, 2026

Thanks for the review !!

Is this something we need to give more direction to Claude on?

My experience is that we definitely to work on adding some .claude/rules for Claude code to help us on writing doc. It needs to know our good practice on how this website works. Interactively I needed to redirect him many time. With the right knowledge I am convinced it will be a really efficient way to draft docs from a PR of new feature.

Happy to discuss that with you @cwickham !

This will prepare for the idea of migrating from one service to the other
Posit Connect Cloud documentation now uses `_publish-command.md` include for consistency with Netlify and Quarto Pub.

This change was done including following improvements

- Refactor `_publish-command.md` to use nested metadata structure:
  - `provider.id`, `provider.name`, `provider.publish-url`
  - `provider.authorization.enabled`, `.description`, `.prompt`
- Add conditional authorization section using `when-meta="provider.authorization.enabled"`
- Update Netlify and Quarto Pub metadata to match nested structure
- Remove generic "Multiple Accounts" section from include (too provider-specific)

Each provider now handles account management documentation in its own way while
sharing the core publish command flow.
Copy link
Collaborator

@cderv cderv left a comment

Choose a reason for hiding this comment

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

I made a few changes as I agree with all your comments. This improve the usability of the include by leveraging when-meta

If you think this is too complex, feel free to amend and then merge

@github-actions github-actions bot temporarily deployed to pull request February 18, 2026 10:20 Inactive
@github-actions
Copy link
Contributor

📝 Preview Deployment

🔍 Full site preview: https://deploy-preview-1879.quarto.org

🔄 Modified Documents

@github-actions github-actions bot temporarily deployed to pull request February 18, 2026 18:13 Inactive
@github-actions
Copy link
Contributor

📝 Preview Deployment

🔍 Full site preview: https://deploy-preview-1879.quarto.org

🔄 Modified Documents

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

Comments