Describe the underlying maths and numerical implementations in vignette

[TimTaylor]

Currently the documentation is missing any real description of the methods employed, both in terms of the underlying mathematics and the numerical solver implementations. Whilst references to papers are given, as a user I would appreciate the package being self contained with all relevant information, including methodology assumptions, available in a vignette.

[pratikunterwegs]

Thanks @TimTaylor - I've been thinking about this for a while as something that's needed, but I don't have the maths chops to describe this usefully (or to know whether I'm correct!) - @BlackEdder or @rozeggo, would you be able to take a stab at this? I remember a hack.md document was written some time ago.

[TimTaylor]

I'll probably raise a general discussion on this point. It really applies to all maths/methods type packages that will be created.

[pratikunterwegs]

Thanks, that would be pretty helpful - see also issue #126 as related. How detailed would you say this needs to be? See for example the vignettes for {cfr} which have some maths - I guess one or two key equations are not enough?

[TimTaylor]

I'd like text book / course level details. Will raise the discussion over next few days, possibly next week.

[TimTaylor]

I was unable to move this issue but I've raised in disucssions. For some reason this hasn't auto-linked hence the comment.

[pratikunterwegs]

Thanks - just saw it. I'm not sure how to move it either yet, haven't used Discussions much, will look into it.