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

JupyterHub page #297

Merged
merged 7 commits into from
Aug 1, 2018
Merged

JupyterHub page #297

merged 7 commits into from
Aug 1, 2018

Conversation

choldgraf
Copy link
Collaborator

This adds a JupyterHub page to the Jupyter website. It adds minimal stylistic changes, basically just enough to accomplish the same design using Jekyll templates and markdown instead of hard-coded HTML.

I'm happy to iterate on design-y stuff later on, but IMO the important thing for this PR is "do we like the content". This landing page should be thought of as a high-level overview of what JupyterHub is and who it could be useful for, as well as links to point people in the right direction for deploying.

Happy to either iterate on this PR or merge and spot-check later

@choldgraf
Copy link
Collaborator Author

cc the jupyterhub team (@minrk @willingc @yuvipanda @jzf2101 @Carreau) since I wanna make sure they're OK with the wording etc!

@Carreau
Copy link
Member

Carreau commented Jul 31, 2018

The one issue I have is on narrow screen the nav bar wraps:
screen shot 2018-07-31 at 09 20 14

Which is one of the reason we don't have too many items in the navbar. Maybe change the widtth of the links ?

@choldgraf
Copy link
Collaborator Author

we could either change the width of the links, or change the @media CSS rule that converts it from a list of links to a button you click to display the links. What would you prefer?

@Carreau
Copy link
Member

Carreau commented Jul 31, 2018 via email

@choldgraf
Copy link
Collaborator Author

re: project drop down, I agree, though I think we should wait and see whatever cool structure @jzf2101 and @tgeorgeux come up with! I am fine with short-term fixes in meantime.

@choldgraf
Copy link
Collaborator Author

ok, added a CSS rule that shrinks the navbar font size when the window hits a width that'd make them overlap with the logo.

@Carreau
Copy link
Member

Carreau commented Jul 31, 2018

What about this that shrink the logo (12pt is too small imho), and restore the hamburger menu in phone.

@choldgraf
Copy link
Collaborator Author

I'm happy with whatever gets the content merged. IMO the design of the site shouldn't be a blocker on the content of the site, so I am happy with whatever layout / CSS is there.

If you'd like to push some more CSS directly to this PR I'm fine with that...my opinion about design should not be a blocker on the PR getting merged :-)

@Carreau
Copy link
Member

Carreau commented Jul 31, 2018

If you'd like to push some more CSS directly to this PR I'm fine with that...my opinion about design should not be a blocker on the PR getting merged :-)

Already done.

@choldgraf
Copy link
Collaborator Author

oh nice! I just pulled pulled and it looks good to me :-) thanks for the code !

hub.md Outdated
## What is JupyterHub?

JupyterHub provides remote access to Jupyter servers on shared infrastructure
in ordre to make computational environments and resources more accessible to
Copy link
Member

Choose a reason for hiding this comment

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

typo - order

@Carreau
Copy link
Member

Carreau commented Jul 31, 2018 via email

@choldgraf
Copy link
Collaborator Author

typo fixed!

netlify is cool! do you know if it works for sphinx pages?

@Carreau
Copy link
Member

Carreau commented Jul 31, 2018 via email

Copy link
Member

@willingc willingc left a comment

Choose a reason for hiding this comment

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

Hey @choldgraf. Thanks for doing this. I think that we should restructure just a bit, but overall this looks good to me.

hub.md Outdated

## What is JupyterHub?

JupyterHub provides remote access to Jupyter servers on shared infrastructure
Copy link
Member

Choose a reason for hiding this comment

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

JupyterHub brings the power of notebooks to groups of users. It gives users access to computational environments and resources without burdening the users with installation and maintenance tasks. Users, including students, researchers, and data scientists, can get their work done in their own workspaces on shared resources which can be managed efficiently by system administrators.

hub.md Outdated
students, researchers, and data scientists.

JupyterHub runs in the cloud or on your own hardware, and makes it possible
to serve a pre-configured data science environment to any user in the world.
Copy link
Member

Choose a reason for hiding this comment

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

data science computational

hub.md Outdated
a variety of user interfaces including the Jupyter Notebook, Jupyter Lab,
RStudio, nteract, and more.

**Secure** - JupyterHub can be configured with authentication in order to
Copy link
Member

Choose a reason for hiding this comment

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

Replace Secure with Flexible

Copy link
Collaborator Author

@choldgraf choldgraf Jul 31, 2018

Choose a reason for hiding this comment

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

do you mean to combine secure and flexible into a single "flexible" section?

Copy link
Member

Choose a reason for hiding this comment

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

I think that we should remove secure as an element and instead call the authentication "flexible" to avoid implicit guarantees of security levels esp. on use of authenticators not maintained by JupyterHub.

Copy link
Member

Choose a reason for hiding this comment

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

Renaming the Flexible section above to another synonym meaning flexible.

Copy link
Collaborator Author

Choose a reason for hiding this comment

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

hehe, ok :-)

how about "customizable"?

Copy link
Member

Choose a reason for hiding this comment

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

That works.

hub.md Outdated

**Portable** - JupyterHub is entirely open-source and designed
to be run on a variety of infrastructure. This includes commercial cloud
providers, virtual machines, even your own laptop hardware.
Copy link
Member

Choose a reason for hiding this comment

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

machines, or even...

hub.md Outdated

## Key features of JupyterHub

**Flexible** - JupyterHub can be used to serve a variety of environments. It
Copy link
Member

Choose a reason for hiding this comment

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

Perhaps Adaptable or Multipurpose

hub.md Outdated
is a Helm Chart for deploying JupyterHub quickly, as well as a semi-complete
guide to deploying and configuring your JupyterHub on Kubernetes.

**[The JupyterHub repository](https://github.com/jupyterhub/jupyterhub)**
Copy link
Member

Choose a reason for hiding this comment

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

Let's move this to the prior section. The foundational JupyterHub code and technology can be found in the JupyterHub repository. This repository and the JupyterHub documentation contains more information about the internals of JupyterHub, its customization, and its configuration.

hub.md Outdated
The Jupyter Community curates two JupyterHub "distributions" for deploying
in the cloud. Follow the links below for more information.

**[The Littlest JupyterHub](https://tljh.jupyter.org)** is a lightweight
Copy link
Member

Choose a reason for hiding this comment

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

Switch the order of these two.

The Littlest JupyterHub, a recent and evolving distribution designed for smaller deployments, provides a lightweight to install JupyterHub on a single virtual machine .

hub.md Outdated
in the cloud. Follow the links below for more information.

**[The Littlest JupyterHub](https://tljh.jupyter.org)** is a lightweight
method to install JupyterHub on a **single virtual machine**. The TLJH
Copy link
Member

Choose a reason for hiding this comment

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

The Little JupyterHub, also known as TLJH, provides a guide...

hub.md Outdated
**[Zero to JupyterHub for Kubernetes](https://z2jh.jupyter.org)** deploys
JupyterHub on Kubernetes using Docker, allowing it to be scaled and
maintained efficiently for **large numbers of users**. Zero to JupyterHub
is a Helm Chart for deploying JupyterHub quickly, as well as a semi-complete
Copy link
Member

Choose a reason for hiding this comment

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

semi-complete

hub.md Outdated

## Join the community

JupyterHub is an open-source and community-driven project. We'd love for you
Copy link
Member

Choose a reason for hiding this comment

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

Like all Project Jupyter efforts, JupyterHub...

Strike just

@choldgraf
Copy link
Collaborator Author

ok I think I addressed @willingc 's comments, LMK if I missed something!

@Carreau Carreau merged commit 382d899 into jupyter:master Aug 1, 2018
@choldgraf choldgraf mentioned this pull request Aug 7, 2018
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.

None yet

3 participants