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

Reviews the nixos.org main page #277

Merged
merged 7 commits into from
Jun 17, 2019
Merged

Reviews the nixos.org main page #277

merged 7 commits into from
Jun 17, 2019

Conversation

samueldr
Copy link
Member

@samueldr samueldr commented May 6, 2019

Elevator pitch

The nixos.org main page virtually traps the user into the Linux Distribution section of the site. This PR intends to make the different moving parts of NixOS more accessible at first glance.


What does it look like?

image

What's been done?

New landing page

The new landing page shows both main components in big visible boxes. The order (left to right) defines their order in narrow mobile layout.

The description was lifted from their respective index pages.

The old nixos.org landing page contents is now the index page of the NixOS sub-section of the site.

New "main" menu

When not inside a project-specific sub-section of the site, the menu will show quick access to the main components of the project. Maybe NixOps should be added to it, that's not my call, but yours.

Misc. CSS fixes

These are minor, could be probably should have been handled separately. Misc things that were not obvious, but once seen are annoyances.

What's left to do?

  • Main menu items.

  • Define the fifth box.

There are two ways to build that box. The first, shown in the current state, and in the screenshot, is to have a small sentence (to be written) heading a list of links to more parts. The second is to describe "The Organization", and link to a new page with more details about how all the parts fit, inspired by the way the Nix Ecosystem page of the NixOS wiki is written.

What's "The Organization"? Maybe I'm mistaken and it should be named "The Foundation", but from what I can gather, The Foundation enables The Organization to exist. The Organization could include projects not supported by The Foundation. I'm probably overthinking this. Additionally, this would help separate the identity of NixOS.org, the GitHub organization and NixOS the distribution.

Future work

This is related #248 but does not address it in full. To be addressed, a new Nix landing page would be needed.

@edolstra
Copy link
Member

edolstra commented May 6, 2019

Looks good. A few remarks:

  • The link to the foundation could be replaced by a link to the Community page (which mentions the foundation).

  • We can probably drop Hydra and maybe NixOps from the front page, since they're really only useful if you're already into the Nix/NixOS ecosystem.

  • Maybe drop "NixOS Nixpkgs Nix" from the navbar, since they're kind of redundant with the content of the page? Or even drop the entire navbar?

@samueldr
Copy link
Member Author

samueldr commented May 6, 2019

Thanks for the review.

@edolstra If I understand right, the content would be:

Nix NixOS                               
Nixpkgs ?? The community

The three-then-two two-then-three arrangement works really well visually, so it'd be a shame to lose it. If we drop NixOps, we're likely to have a hole in the bottom row.

Additionally, NixOps already is on the landing page for NixOS, so it might have some merit to stay there, at least until something else more important is found to replace it on the landing page.

As far as "The Community" section would go, I guess it would hold two links, one to the "NixOS Community" page, and the other to "NixOS support", though I am unsure of what to write as a quick one or two sentences blurb to put in front of the links. If anyone has suggestions. (I'll think about it too.)


Dropping the navbar entirely would trap a user knowing to access sub-sections of the site using the logo drop-down. Even though they're likely to know the full address for e.g. NixOps, they could likely be used to click the logo, then NixOps.

As far as dropping the contents of the navbar on the landing page. Yeah, that's fine, but it will look a bit empty, unless it ends up holding links to non project-specific pages like News or others. Though, losing the quick access links is not a big deal imo, and would ensure we can use the space for other links when we need to.

@edolstra
Copy link
Member

edolstra commented May 6, 2019

Yeah, I agree two-then-three (I assume you meant that) works better. So that's an argument for keeping NixOps on the front page :-)

Indeed I was talking about the navbar on the landing page.

@grahamc
Copy link
Member

grahamc commented May 6, 2019 via email

samueldr added 4 commits May 7, 2019 21:59
This menu is used on the "organization" website, which means the
non-project-specific sites. The menu options refers to the main
components of the NixOS organization, as a quick access menu on the
front page.

 + note about donation.tt
This is slight, but the brand will stretch the header by
1.5~2px, which is slight, but noticeable when you know it.
From the nixos.org main page, there is was no way to quickly glance at
the moving parts of the NixOS project, that is Nix and Nixpkgs. Only
NixOS was represented.

This is a step into fixing an issue that @garbas brought forward at the
last NixCon, where the landing page of NixOS.org and the nix landing
page lacks in "actionability".

From the new nixos.org main page, it is easier to go straight to the Nix
specific section of the site. In a follow up work, the main Nix web page
can be re-worked to "show off" more what Nix is about.
@samueldr
Copy link
Member Author

samueldr commented May 8, 2019

Updated the last new box:

image

I'm not sure about the text: please provide something better if you want and can!

Other than that, this is ready.

@samueldr samueldr marked this pull request as ready for review May 8, 2019 02:01
@davidak
Copy link
Member

davidak commented Jun 4, 2019

Very good work!

In the NixOS section, do we need "Nix" to be a link? I think we have it already on the left.

I think we should articulate "many other advantages" or delete the words. More informations are provided after clicking the more button.

NixOps section: "configura-tion"

Community section: Maybe first declare that "This is a community effort"

The texts can be improved more, but that is a topic for another PR.

@edolstra edolstra merged commit 9f2f846 into NixOS:master Jun 17, 2019
@edolstra
Copy link
Member

Thanks @samueldr!

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.

4 participants