Skip to content
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.

Sign up for GitHub

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

Helpful hints for Positron on Workbench #18

Closed
wants to merge 3 commits into from
+40 −6
Closed

Helpful hints for Positron on Workbench #18

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
dff0c7f
Start draft of Positron on Workbench helpful hints
juliasilge Nov 13, 2024
226300e
Contractions!
juliasilge Nov 13, 2024
ae52cc4
Additional notes, based on feedback from @jthomasmock
juliasilge Nov 15, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 7 additions & 6 deletions _quarto.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ project:
- "*.qmd"

website:
announcement:
announcement:
icon: info-circle
dismissable: false
content: "Positron is available for beta testing and [may not yet be a good fit for you](start.qmd#is-positron-for-me). If you are interested in experimenting with it, we welcome your [feedback](feedback.qmd)!"
Expand All @@ -31,12 +31,12 @@ website:
href: "https://docs.posit.co/"
- text: "<img alt='Link to main Posit site' src='images/posit-icon-fullcolor.svg' id='footer-right-posit-logo'>"
href: "https://posit.co/"
navbar:
navbar:
left:
- text: "Get Started"
href: start.qmd
href: start.qmd
- text: "Guides"
href: interpreters.qmd
href: interpreters.qmd
- text: "Help"
href: troubleshooting.qmd

Expand All @@ -56,11 +56,12 @@ website:
- connections-pane.qmd
- run-interactive-apps.qmd
- updating.qmd
- workbench.qmd

- title: "Help"
style: "docked"
contents:
- troubleshooting.qmd
- feedback.qmd
- faqs.qmd
- faqs.qmd

17 changes: 17 additions & 0 deletions workbench.qmd
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
---
title: "Positron on Workbench"
juliasilge marked this conversation as resolved.
Show resolved Hide resolved
---

Positron is available as a preview feature on [Posit Workbench](https://posit.co/products/enterprise/workbench/) as of its 2024.12.0 release. Important information about using Positron on Posit Workbench is available in the Workbench documentation [for admins](https://docs.posit.co/ide/server-pro/2024.12.0/positron_sessions/) and [for users](https://docs.posit.co/ide/server-pro/user/2024.12.0/positron/getting-started/), but we also want to highlight a few ways to have the best possible experience during this preview period.
Copy link
Collaborator

Choose a reason for hiding this comment

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

Suggested change
Positron is available as a preview feature on [Posit Workbench](https://posit.co/products/enterprise/workbench/) as of its 2024.12.0 release. Important information about using Positron on Posit Workbench is available in the Workbench documentation [for admins](https://docs.posit.co/ide/server-pro/2024.12.0/positron_sessions/) and [for users](https://docs.posit.co/ide/server-pro/user/2024.12.0/positron/getting-started/), but we also want to highlight a few ways to have the best possible experience during this preview period.
Positron is available as a preview feature on [Posit Workbench](https://posit.co/products/enterprise/workbench/) as of its 2024.12.0 release. Important information about using Positron on Posit Workbench is available in the Workbench documentation [for administrators](https://docs.posit.co/ide/server-pro/2024.12.0/positron_sessions/) and [for users](https://docs.posit.co/ide/server-pro/user/2024.12.0/positron/getting-started/), but we also want to highlight a few ways to have the best possible experience during this preview period.

Copy link
Collaborator

Choose a reason for hiding this comment

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

Also - Workbench hasn't released yet so we will likely want to hold this PR until its release.

Copy link
Member

Choose a reason for hiding this comment

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

@juliasilge The hints have been moved over to the Workbench User Guide and are available at: https://docs.posit.co/ide/server-pro/user/2024.12.0/positron/getting-started/!

Now that the main content is in the Workbench docs, maybe we just need this blurb? We could link directly to https://docs.posit.co/ide/server-pro/user/2024.12.0/positron/reference/other-resources.html in addition to the User Guide and Admin Guide links already in this blurb.


## Install binary R packages on Workbench

Posit Workbench runs on Linux, but CRAN does not build Linux binaries for R packages. You _can_ install R packages using the default configuration, but you will likely find the process extremely slow. Instead, consider using a CRAN-like repository that provides binaries for your Linux architecture, such as [Posit Package Manager](https://packagemanager.posit.co/) and set that via `options()`. For example, if your Workbench is installed on Ubuntu 22.04 (Jammy), you would use:
juliasilge marked this conversation as resolved.
Show resolved Hide resolved

```r
options(repos = c(CRAN = "https://packagemanager.posit.co/cran/__linux__/jammy/latest"))
```

If you run this one time, you will set your `option` for the current R session. If you add this code to the `.Rprofile` in your home directory on Workbench, it will apply to all your R sessions.

Follow along [on GitHub](https://github.com/posit-dev/positron/issues/5318) to learn about our plans for a better solution in the long term.
Loading