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

reduce number of menu items #27

Open
bob-carpenter opened this issue Dec 27, 2016 · 4 comments
Open

reduce number of menu items #27

bob-carpenter opened this issue Dec 27, 2016 · 4 comments

Comments

@bob-carpenter
Copy link

bob-carpenter commented Dec 27, 2016

This is from @andrewgelman, who wants to reduce the number of menu items on the top page in order to focus user search. The plan will require more clicks to get to some things but there will be fewer choices at each stage.

  • What should we do about the workshop pages and other "hidden" content?

  • Any URLs that go away should forward somewhere reasonable or be replaced with a page to manually follow.

Here's the new plan from @andrewgelman:

Home Page

As is.

Top-level Menu Items

These will be the menu choices on the home page and the targets of the menu items:

  • Interfaces
  • Documentation
  • Issues
  • Community

The first three will remain the same.

Community will get a landing page with links to all the previous pages:

  • Users list and dev list (was what we called "Community" before)
  • Bug Reports & Feature Requests
  • Events
  • How to Cite & Citations
  • Team
  • Developer Resources
  • Contributions & Supporters

If we can figure it out, it might make sense to have a submenu of some kind. Otherwise, each of the pages will only have the top-level menu items and it'll be a challenge as to how to lay out that community page index, as it'll require a bit of explanation for each item and some scrolling.

What we have now

Thsi is just an outline of the current site (as of this issue submission):

CAPS are menu pages. Bold items have their own web page.

HOME

  • what is Stan
  • how to get started
  • how to donate (remove NuMFOCUS logo and simplify link to contributions)

INTERFACES

  • Language
    • RStan, PyStan, ...
  • Higher Level
    • RStanArm
    • ShinyStan
  • Lower Level
    • Math library
    • Stan library
  • Useful tools
    • Loo
    • Bayesplot
    • rstantools

DOCS

  • Manual
  • Example Models
  • Case Studies
  • Tutorials
    • video
    • web tutorials
    • papers
    • books

ISSUES

  • Bug Reports
  • Feature Requests
  • Submit fixes

EVENTS

  • meetups
  • talks
  • courses
  • cons

COMMUNITY

  • users group
  • dev group

CITE

  • How to cite Stan
  • Books about Stan
  • Boosks with examples translated to Stan
  • Papers about Stan
  • Papers using Stan
  • Theses using Stan
  • Papers using NUTS
  • Software using Stan
  • Software using NUTS

TEAM

  • Core Developers
  • Alum developers

DEVELOP

  • suggest or discuss code patches
  • contribute code patches
  • to do list and projects
  • how to join the dev team
  • source repos

SHOP

  • US shop
  • UK shop

SUPPORT

  • Contribute to Stan
  • Donors
  • R&D grants
  • Industrial consulting

We also have a hidden page that doesn't have a menu item or any links to it from the site:

Workshops

  • birds
  • icl_epi
  • ...
@jgabry
Copy link
Member

jgabry commented Dec 27, 2016

I've always found the most frustrating part of the website to be the lack of a table of contents (or something along those lines) at the top of each page. That is, not knowing what's on a page without having to scroll through the whole thing. For example, the current Citations page has "How to Cite Stan" as the header, which is fine, but there's a lot more on the page besides what is described by "How to Cite Stan". There are also books about Stan, papers using Stan, books with examples translated into Stan, etc.

Reducing the number of menu items sounds good to me, but then I think it will be even more important to have a table of contents at the top of each page linked to from the menu since there will now be even more content per page (or at least more content linked to from each page).

@bob-carpenter
Copy link
Author

bob-carpenter commented Dec 27, 2016 via email

@jgabry
Copy link
Member

jgabry commented Dec 27, 2016 via email

@bob-carpenter
Copy link
Author

@jgabry on the mailing list suggested that we not have deep nesting on a page like on the current citations and docs pages (where you have to scroll down to see what's there). One solution would be a table of contents on each page and another would be shorter (but more deeply nested) pages.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants