New improved Stan docs website

Publicity
1

Stan docs have a new look and are now built using Quarto!

check them out!

17 Likes
2

These look good.

May I recommend that there is some kind of link to the pdf location at some point on the main pages of these?

3

excellent suggestion! add links to pdfs from docs homepage and overview pages Ā· Issue #736 Ā· stan-dev/docs Ā· GitHub

4

I like the new look! My only suggestion is that there should be a link back to the mc-stan.org home page somewhere. Clicking on the Stan logo just takes you to the documentation home.

5

Nice! I didnā€™t notice a dark mode as we had before which I used, but thatā€™s available in Quarto too: Quarto ā€“ HTML Theming

6

request noted - add dark mode for website Ā· Issue #738 Ā· stan-dev/docs Ā· GitHub

1 Like
7

updates:

  • links to pdfs from the docs landing page are live

  • weā€™ve added an online index for the Stan Functions Reference - Alphabetical Index

2 Likes
8

Dark mode is now available! Just in time for the US eclipse ;)

2 Likes
9

Hereā€™s a very preliminary version of using the Stan docs theming for the mc-stan.org website: Stan

The repo is here: GitHub - mitzimorris/stan-website: Do-over of mc-stan.org using quarto and mc-stan.org/docs theming

This is very much a work in progress and your feedback and comments are most welcome!

Thereā€™s several more pages of great content in the stan-dev.github.io repo that needs to be ported over - if youā€™d like to help with the updating and reorganization, please file issues or PRs on this repo.

10

Stan: Open-Source Software for Statistical Modeling

This is more clear than the current website but I think it would be better to be more clear with something like

Stan: A Programming Language and Ecosystem for Statistical Modeling

Interfaces for Python, R, and Julia

I think we should say ā€œand moreā€ somewhere. I think there is a statsstan and matlabstan?

Legacy interfaces:

  • RStan (latest supported Stan release: 2.32)

Ben still maintains this and itā€™s used by many packages so idt we should label it as legacy

When you click one of the links in Documentation can we have it open a new tab instead of going to a new site? The header changed after I clicked and I was confused

Can we have ā€˜related toolsā€™ be a page that lists the different packages like how the CRAN Task Views look?

I know the ā€œAbout the Stan Projectā€ is inherited from the old site but we should really have a space that says ā€œhere is what Stan doesā€

Overall I like it!

1 Like
11

we might be getting Rust interface.

at one point I think different contributors developed StataStan, ScalaStan, MatlabStan.
if we list them, weā€™d need to figure out what Stan release a user would have to install in order to run them - I donā€™t know enough about the implementations to know whether or not theyā€™d break on V 2.34.

youā€™re correct. bad use of ā€œlegacyā€. we need a more nuanced discussion here.

while itā€™s cool to have lots of different interfaces, the ones that matter are the one that are (most) used, and for the best user experience, we shouldnā€™t advertise things that no longer work.

1 Like
12

The last commit has been 7 years ago. I assume itā€™s not working well anymore. Based on the issues and PRs, someone has been using it still in 2023 by fixing it themselves, but @brian-lau nor anyone else has not touched the repo or replied to any issues or PRs in 7 years.

1 Like
13

This looks great!

In addition to Steveā€™s suggestions, it looks like the Related Tools dropdown is missing a bunch of the important R packages. They are listed in the Other Packages dropdown at the new docs page Stan Docs - Stan Documentation (I think that list is up to date).

Thanks for working on this!