Hey all, We got into a conversation about what our wiki on versioning and compatibility means w.r.t. the Stan Math library. We brought it up at the meeting yesterday, but @syclik wasn’t around and so I wanted to summarize the consensus from that meeting online and perhaps engage Daniel and the othe…

Talked with @syclik on the phone and he mentioned that people were confused about what “supported external API” means. This post will clarify what that means and what the API is. The API is a description of the functionality that we advertise as working and supported to other people, and that we pr…

[image] seantalts: We brought it up at the meeting yesterday, but @syclik wasn’t around and so I wanted to summarize the consensus from that meeting online and perhaps engage Daniel and the others from the meeting here if there’s more to be worked out. Thanks for putting up the post! Btw, I j…

That all sounds good pretty much, just a few minor things, plus I think we have more to talk about on the PR but I think that conversation should continue on the PR thread. I definitely like saying that we should keep just stan/math.hpp as the supported entrypoint and not rename var, any math functi…

Awesome. We’re agreed on everything. I’ll continue the discussion on the PR thread. [image] seantalts: I think meta should only contain non-client facing stuff, so maybe we should move size out? I think meta used to be short for “C++ Template Metaprograms,” but now it has such a wide array of s…

I edited the wiki page with the extra 4 words and added a link to this new page , where I tried to summarize our discussion.

I was just reading this SemVer article on HN and the first thing it mentions is from the introduction to the 2007 version of Semantic Versioning: I propose a simple set of rules and requirements that dictate how version numbers are assigned and incremented. For this system to work, you first need …

[image] mitzimorris: should the wiki page link to the online doxygen docs, i.e. the github pages: We don’t have the code (and thus the doxygen) organized in such a way that distinguishes what we’re supporting and what we aren’t (other than the fairly new internal namespace), so it might be mo…

@syclik and I got into another discussion of this and some related issues in https://github.com/stan-dev/math/pull/1186 . I’ll try to summarize and move the discussion here: I want to distinguish between three general Math library issues that came up: What modes / headers / directories require tes…

The link looks broken from here, which discussion?

Here: https://github.com/stan-dev/math/pull/1186

What is the supported external API of the Math Library?

Developers

mitzimorris February 11, 2019, 11:03pm 8

should the wiki page link to the online doxygen docs, i.e. the github pages:
http://mc-stan.org/math/
cheers,
Mitzi

Topic		Replies	Views
Standard for reviewing pull requests in the Math library Developers	16	1647	June 2, 2018
The Future of the Math Library and the Bottlenecks in Development Developers	10	1590	February 23, 2019
What doc would help developers of the Math library? Developers	32	3066	August 9, 2018
Level of Review Necessary for (math) PRs Developers math	16	1314	October 31, 2019
Contributing New Functions to Stan (dev guide page) Developers	11	1286	August 17, 2017

What is the supported external API of the Math Library?

Related topics