stan-dev / stan-dev.github.io

Stan website based on the So Simple Jekyll theme.
https://mc-stan.org/
19 stars 38 forks source link

Redesign #92

Open imadmali opened 5 years ago

imadmali commented 5 years ago

I have some suggestions for the existing Stan website from my experience of using the site and introducing new users to Stan via the site.

Discoverability

While the current site does a decent job of establishing Stan's presence online, I think it's limited in the ability for new user's to discover information/interfaces/case studies/etc. regarding Stan. I'm not a huge fan of having long sidebars on sites, but it might help with discoverability (e.g. see the JTD jekyll theme).

I've lightly surveyed some popular open source libraries and it looks like they mix the documentation-like sidebar theme with a aesthetically pleasing landing page:

I'm not saying that we should emulate these sites. They have a lot more bells-and-whistles than we need. But their exposition of information might be worth considering.

One limiting factor for Stan (that is also a huge feature of the language) is how many interfaces we have. This makes it a little challenging to make the site a one-stop-shop for all users (the way the sites mentioned above are, more or less).

Flow for New Users

Another thing to note is that the purpose of the site is not clear for new users to Stan. One example of flow for new users could be,

  1. Landing page
  2. Interface/Installation
  3. Quick Start
    • For popular interfaces RStan/PyStan/etc
    • Using a super basic example
  4. Documentation
    • For users who are ready to go beyond the basic example presented in Quick Start

I'm not saying that these should be the only buttons on the nav bar, but rather that the site should be setup in a way that once a new(ish) user arrives at the landing page, there should be a clear path for them to get their hands dirty and get more information if they're interested.

I've suggested an example layout below,

jgabry commented 5 years ago

Thanks for working on this. I think this "flow" would be a big improvement!

mitzimorris commented 5 years ago

I wholeheartedly support this proposal. note that we really do need to accomodate mobile viewers, where all top nav bars become lists, etc.

e.g. see the JTD jekyll theme

the choice of jekyll theme is always the most difficult question. the current theme is a nightmare to work with. can we formulate criteria for the type and number of page elements?

mitzimorris commented 5 years ago

here's a site of Jekyll themes - hardly exhaustive - http://jekyllthemes.org worked through all 20 pages of examples - still haven't found what I'm looking for...

in the beginning of the year, I tried this one - no longer remember why - https://chrisanthropic.github.io/slim-pickins-jekyll-theme/

for the landing page: https://jekyllthemes.io/jekyll-landing-page-themes

this one? https://jekyllthemes.io/theme/feeling-responsive