Skip to content

Add details to README - #152

Draft
skaltman wants to merge 7 commits into
mainfrom
readme
Draft

Add details to README#152
skaltman wants to merge 7 commits into
mainfrom
readme

Conversation

@skaltman

@skaltman skaltman commented Aug 21, 2026

Copy link
Copy Markdown
Collaborator

Updates and adds more detail to the README, including a section on the eval results from DevRel Agent.

  • I can update the gif when the commons UI settles.
  • The DevRel agent data is temporarily hardcoded. I opened an issue to include a file with the results so we can read in the data here.
image

@github-actions

github-actions Bot commented Aug 21, 2026

Copy link
Copy Markdown

Preview deployed to Connect (dogfood.team.pct.posit.it): https://dogfood.team.pct.posit.it/connect/#/apps/d7a36cae-8f27-448b-a478-61b81fbe3942/draft/363644

Deployed from commit 83c81da.

@github-actions

github-actions Bot commented Aug 21, 2026

Copy link
Copy Markdown

Preview deployed to Connect (connect.staging.pct.posit.it): https://connect.staging.pct.posit.it/connect/#/apps/ad662e1b-5048-4acc-9ad7-f9478c92274e/draft/2129

Deployed from commit 83c81da.

@simonpcouch simonpcouch left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Just one small reproducibility ask, otherwise looks great.

Linking to #146, which also makes some README edits. Whichever one merges second will need to reconcile edits from the other.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Really sharp, I dig this plot.

Comment thread README.md
commons](https://posit-dev.github.io/commons/articles/commons.html)
vignette.

<img src="man/figures/README-trust-flow.png" alt="A question first searches trusted calculations. The high-trust path runs a relevant trusted calculation and produces a verified answer. The lower-trust path searches context and writes custom SQL or R, producing either a cited or untrusted answer." width="100%" />

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Is there source code for this figure somewhere? (The Getting Started vignette, I'm guessing?) Could we include a link to it in an HTML comment?

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