Skip to content

Get Started > Positron #1692

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

Merged
merged 40 commits into from
Jul 17, 2025
Merged

Get Started > Positron #1692

merged 40 commits into from
Jul 17, 2025

Conversation

cwickham
Copy link
Collaborator

@cwickham cwickham commented Jun 11, 2025

Audience

For Positron users, assume these are people who work with data (as opposed to VS Code flow, where readers might be software developers, or more scientific computing types).

Assume no prior knowledge of similar systems, e.g. RMarkdown.

Summary

This is mostly a reuse and blend of the RStudio and VS Code flows with the following big modifications:

  • R and Python options with the same document content
  • Positron-specific screenshots where appropriate
  • computations/positron.qmd - it felt like there was too much material in this one so I trimmed heavily. Added a "Cell Workflow" section.

Thoughts and questions

  • Can we add some CSS to minimize the appearance of the tabsets? I.e. I want to keep the tab headers (although maybe they could move to right), but would like to have tab content inline with other content (i.e. not indented). Done

  • The example doc doesn't show computational output in the initial screenshot. Should we re-write to move a code cell earlier? A bit more like: https://quarto.org/index.html#python-tab. Yes, it removes dependency on an external image, and helps cement the purpose of computational cells.

  • It might be nice to include more advanced features in the example doc like a cross-reference, or a caption. Now includes cross-reference.

  • Would Python users be put off by using plotnine as opposed to something like matplotlib? (I personally like that the two example documents look identical despite the language used to create them). Verdict is, no, this is fine.

  • Currently, this is mostly a "look at this tutorial". Should it involve more doing? I.e. "Edit the heading and re-render". No problems with first page being mostly "look at this". Next steps, could be more "do this".

@github-actions github-actions bot temporarily deployed to pull request June 11, 2025 21:42 Inactive
Copy link
Contributor

@jthomasmock
Copy link
Contributor

Howdy @cwickham -- would this be OK to rollout by the start of July? Any review of revisions we can help with?

@github-actions github-actions bot temporarily deployed to pull request June 24, 2025 16:16 Inactive
Copy link
Contributor

@github-actions github-actions bot temporarily deployed to pull request June 24, 2025 22:49 Inactive
Copy link
Contributor

@github-actions github-actions bot temporarily deployed to pull request June 27, 2025 23:02 Inactive
@github-actions github-actions bot temporarily deployed to pull request June 30, 2025 18:03 Inactive
@github-actions github-actions bot temporarily deployed to pull request June 30, 2025 20:14 Inactive
@github-actions github-actions bot temporarily deployed to pull request July 15, 2025 19:03 Inactive
@cwickham
Copy link
Collaborator Author

@mine-cetinkaya-rundel and @juliasilge, I made some changes to the language picker. How do you feel about it here: https://deploy-preview-1692.quarto.org/docs/get-started/hello/positron.html ?

Thanks for all the feedback, I think I've addressed it all now.

I still need to do a full round of screenshots (light and dark, no yellow tint) before merging.

@mine-cetinkaya-rundel
Copy link
Collaborator

That looks great to me!

@github-actions github-actions bot temporarily deployed to pull request July 16, 2025 22:20 Inactive
@github-actions github-actions bot temporarily deployed to pull request July 17, 2025 20:12 Inactive
@github-actions github-actions bot temporarily deployed to pull request July 17, 2025 20:26 Inactive
@github-actions github-actions bot temporarily deployed to pull request July 17, 2025 20:33 Inactive
@github-actions github-actions bot temporarily deployed to pull request July 17, 2025 21:03 Inactive
@cwickham cwickham merged commit 1715f6e into main Jul 17, 2025
4 checks passed
@cwickham cwickham deleted the positron-get-started branch July 17, 2025 21:09
github-actions bot pushed a commit that referenced this pull request Jul 17, 2025
(cherry picked from commit 1715f6e)
Copy link
Contributor

Successfully created backport PR for prerelease:

cwickham added a commit that referenced this pull request Jul 17, 2025
(cherry picked from commit 1715f6e)

Co-authored-by: Charlotte Wickham <[email protected]>
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.

5 participants