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

reduce number of menu items

オープン
#27 コメント 4 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

enhancement
主要言語
HTML
スター
23
フォーク
41
平均マージ
11時間 42分
マージ済み PR(30日)
2

説明

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

コントリビューションガイド

このリポジトリのコントリビューションガイドは索引されていません

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

調査の方向性

まず、サイトの現在のナビゲーションと、issue に記載されているページグループ(Community と非表示の Workshops ページを含む)を確認します。提案されているトップレベルメニューを既存のページにどのように対応付けるかを決定し、削除される URL を監査します。縮小されたナビゲーションが実装され、非表示のコンテンツが対処され、影響を受ける URL に妥当な移行先がある状態を完了とします。

索引モデルが issue の本文から書いたものです。

評価

技術スタック
html
領域
content, web-dev
issue の種類
機能追加
難易度
5/5
見積もり時間
1週間以上
活発さ
停滞
明瞭さ
説明が足りない
初心者へのやさしさ
25/100

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。