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.

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

Clarify the options for static site hosting and "live server" hosting #927

Open
Tracked by #1002
choldgraf opened this issue Feb 21, 2024 · 2 comments · May be fixed by #1262
Open
Tracked by #1002

Clarify the options for static site hosting and "live server" hosting #927

choldgraf opened this issue Feb 21, 2024 · 2 comments · May be fixed by #1262
Labels
documentation Improvements or additions to documentation enhancement New feature or request

Comments

@choldgraf
Copy link
Collaborator

choldgraf commented Feb 21, 2024

Proposal

The deployments page in the documentation has some guidance for how you can deploy a MyST book/article to the internet. It discusses a bit about "live" vs. "static" hosting, and then describes how to deploy to GitHub Pages and to CurveNote.

I think a few things could be improved to make it a bit clearer, so noting it here:

  1. It could use a more in-depth description of the differences between a "live" app and a static website, but potentially moved to the bottom since it's probably not the most important information. Why / when would you want one vs. the other, etc.
  2. Clarify that the "CurveNote" option is a "live app" option, not a static HTML option.
  3. Describe how to deploy "live apps" on other common services like Netlify (I don't think it's possible on GitHub?)
@choldgraf choldgraf added documentation Improvements or additions to documentation enhancement New feature or request labels Feb 21, 2024
@agoose77 agoose77 assigned agoose77 and unassigned agoose77 Feb 22, 2024
@agoose77
Copy link
Contributor

I took a look at answering this, but there are some nuances about what static vs dynamic means in this context that I'm not fully knowledgeable on. As such, I've released the self-assignment.

@choldgraf
Copy link
Collaborator Author

I believe that @rowanc1 said that he's done this with Vercel, maybe that's the place to start to try it out?

https://vercel.com/

If 2i2c is going to start recommending communities use MyST maybe we can plan out some work to test it out ourselves and then write documentation about it. Doesn't have to be now but when the time is right!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation enhancement New feature or request
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants