Skip to content

Reorganize Menus: Get Started and Concepts (no tutorials) #261

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 93 commits into from
Apr 29, 2025

Conversation

chendaniely
Copy link
Collaborator

@chendaniely chendaniely commented Mar 14, 2025

Just the get started and concept pages from #250 4751da3
does not include the tutorials.

Does a re-write for the get started introduction, and fixes up the install, create and run pages to include Positron.

  • Before we merge this, we should decide where the "Learn Shiny" Button links to on the main index page, or maybe we call that get started and link to the first get started page.

I have a few other ideas for the home page, but that can be a separate PR/discussion.
I put a 👍 on the conversations that have been resolved, and used the 🚀 to signal this conversation was moved to another issue.

TODO

  • homepage: Remove install link button
  • homepage: Change "Learn" to "Get Started"
  • homepage: Use bsicons instead of emoji
  • homepage: Use #index p a instead of .homepage-code p a and include color: white
  • get-started: alt text for the code snippet
  • get-started: maybe resize gallery images to 4x3
  • what-is-shiny: check links
    • (built-in theming)
  • create-and-run: re-record shiny create video

Bug bash:

@chendaniely chendaniely self-assigned this Mar 14, 2025
@github-actions github-actions bot temporarily deployed to pr-261 March 14, 2025 07:34 Destroyed
@github-actions github-actions bot temporarily deployed to pr-261 March 14, 2025 07:42 Destroyed
@chendaniely chendaniely requested a review from gadenbuie March 14, 2025 08:06
@github-actions github-actions bot temporarily deployed to pr-261 March 14, 2025 08:33 Destroyed
@github-actions github-actions bot temporarily deployed to pr-261 March 15, 2025 04:41 Destroyed
@gadenbuie
Copy link
Contributor

  • Before we merge this, we should decide where the "Learn Shiny" Button links to on the main index page, or maybe we call that get started and link to the first get started page.

Let's link "Learn Shiny" to the first Get Started page

@github-actions github-actions bot temporarily deployed to pr-261 March 17, 2025 22:37 Destroyed
@github-actions github-actions bot temporarily deployed to pr-261 March 17, 2025 23:55 Destroyed
@github-actions github-actions bot temporarily deployed to pr-261 March 18, 2025 01:47 Destroyed
@github-actions github-actions bot temporarily deployed to pr-261 March 18, 2025 06:20 Destroyed
@github-actions github-actions bot temporarily deployed to pr-261 April 25, 2025 14:32 Destroyed
@gadenbuie

This comment was marked as off-topic.

@github-actions github-actions bot temporarily deployed to pr-261 April 25, 2025 14:57 Destroyed
@github-actions github-actions bot temporarily deployed to pr-261 April 25, 2025 16:30 Destroyed
@github-actions github-actions bot temporarily deployed to pr-261 April 25, 2025 16:52 Destroyed
@github-actions github-actions bot temporarily deployed to pr-261 April 28, 2025 13:34 Destroyed
@github-actions github-actions bot temporarily deployed to pr-261 April 28, 2025 13:39 Destroyed
## Extensibility {#extensible}

While Shiny includes everything you need to build an app, it is also built on a foundation of web standards, making it highly [extensible](/docs/custom-component-one-off.qmd).
In fact, Shiny for Python is built on standard HTML
Copy link
Contributor

@cpsievert cpsievert Apr 28, 2025

Choose a reason for hiding this comment

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

Suggested change
In fact, Shiny for Python is built on standard HTML
In fact, a Shiny frontend can be built entirely from HTML, and is compatible with any JavaScript framework.

Copy link
Contributor

Choose a reason for hiding this comment

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

idk, I think what we're trying to communicate here is the classic, it's just standard web stuff in the end. At this stage, I think that's a compelling thing to say. Two practical consequences of this choice are:

  1. you can use Shiny to learn about developing for the web (and lots of people have!) by inspecting our UI elements
  2. you're not locked in to what we've made for you, you can always make components or apps that work with things we haven't included.

I like the idea of folding React (or other frameworks) into this section, but I think "compatible with any JavaScript framework" oversells the connection in a way that will miss people who would find the points above compelling, but would be underwhelming to people who are familiar with React or other frameworks and who might think this means it's easy to swap out frameworks.

Copy link
Contributor

Choose a reason for hiding this comment

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

I updated this section to blend the above ideas

Copy link
Contributor

@cpsievert cpsievert left a comment

Choose a reason for hiding this comment

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

LGTM once nitpicks are addressed, thanks!

@github-actions github-actions bot temporarily deployed to pr-261 April 29, 2025 02:15 Destroyed
@github-actions github-actions bot temporarily deployed to pr-261 April 29, 2025 03:00 Destroyed
@gadenbuie gadenbuie merged commit d6b3ef2 into main Apr 29, 2025
1 check passed
@gadenbuie gadenbuie deleted the get-started-concepts-only branch April 30, 2025 20:26
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.