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…

Just to highlight the proposed change, the additional text being proposed for the wiki is in {}. A change in a library breaks backward compatibility if a program using {only supported APIs} that worked in the previous version no longer works the same way in the current version. For backward-compat…

[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 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 …

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

[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?

What is the supported external API of the Math Library?

Developers

seantalts February 1, 2019, 9:56pm 6

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.

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

What is the supported external API of the Math Library?

Related topics