Intro chapter#961
Conversation
WardBrian
left a comment
WardBrian
left a comment
There was a problem hiding this comment.
This looks good overall, thanks. Most of my comments are suggestions for places for more cross linking to other doc, which I think never hurts
|
|
||
| ### Stan GitHub organization | ||
|
|
||
| {#fig-stan-projects width=75% fig-align="center"} |
There was a problem hiding this comment.
Not sure how stan-ecosystem.png was created, but note that Quarto supports both Mermaid and Graphviz natively: https://quarto.org/docs/authoring/diagrams.html
The former would even let the nodes be clickable
There was a problem hiding this comment.
tikz. I didn't want to include the LaTeX source as I'm not sure mathjax could handle something like that.
| Stan such as the `rstanarm` and `brms`, both of which are based on R's | ||
| expression language for regressions. The project also develops and | ||
| maintains visualization and model comparison tools like `posterior` | ||
| and `loo` (in R; for Python, similar functionality is available through | ||
| `ArviZ`). |
There was a problem hiding this comment.
Every package might as well be a link IMO
There was a problem hiding this comment.
You're right. I completely reorganized and filled in a bit more detail and grouped better.
|
@WardBrian: This is ready to review again. I think I covered all your requests---I left the ones unresolved that were more judgement calls. |
2 participants
Submission Checklist
<<{ since VERSION }>>Summary
This is adding two introductory chapters, "The Stan Ecosystem" and "How Stan Works".
The first chapter summarizes the projects and how they fit together. There's a diagram of GitHub repos and dependencies for the core modules. The second chapter summarizes the reference manual with a couple short examples.
Copyright and Licensing
Please list the copyright holder for the work you are submitting (this will be you or your assignee, such as a university or company):
Simons Foundation
By submitting this pull request, the copyright holder is agreeing to license the submitted work under the following licenses: