stan-dev / stan-dev/stan-dev.github.io

reduce number of menu items

Open
#27 4 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
Dominant language
HTML
Stars
23
Forks
41
Avg merge
11h 42m
Merged PRs (30d)
2

Description

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
  • ...

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the site's current navigation and the page groups listed in the issue, including Community and the hidden Workshops pages. Decide how the proposed top-level menu maps to existing pages, and audit URLs that would be removed. Done means the reduced navigation is implemented, hidden content is addressed, and affected URLs have a reasonable destination.

Written by the indexing model from the issue text.

Assessment

Tech stack
html
Domain
content, web-dev
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.