This could be accomplished in stages:

• remove references in gitbook
• remove warnings in gempyor
• remove references in scripts
• remove references in r packages

Probably gitbook items first (@TimothyWillard hotfix? since its already deprecated), but then the rest in any order (probably non-hotfix).

Quick question for anyone to answer:

Not sure what weight data_var has, as it as listed as a column in the data_path file. How should I handle data_var?. Should I remove it as well, since data_path will not longer exist? Or should I re-route its explanation to a different file?

ss from this page on the gitbook.

Hmm - I think those are explicitly labelled "OLD" at the moment, so we can ignore them for now.

At some point we'll want to support flepimop-versioned-user guide that people can select the version they're working from. I think sphinx may "just work" to provide that kind of support, if we approach the general user guide as part of the API.

That's a longer term effort, I'd guess.

Hmm - I think those are explicitly labelled "OLD" at the moment, so we can ignore them for now.

At some point we'll want to support flepimop-versioned-user guide that people can select the version they're working from. I think sphinx may "just work" to provide that kind of support, if we approach the general user guide as part of the API.

That's a longer term effort, I'd guess.

Yep you're right, those gitbook files are labeled OLD. But this same data_var as a column in data_path also appears in inline roxygen2 documentation. So, I guess my question still stands, as how would you prefer this reference to be resolved? Photo provided of R documentation:

which R is that from? the scripts or one of the packages?

If those params are still used in the corresponding function args, that param documentation can remain until we also revise those function signatures (in later stages of resolving this deprecation issue).

it's from yaml_utils.R

It's in the flepiconfig R package. data_var seems pretty embedded in the functions of that file.

Got it - I'm actively working on the refactor for it, so don't worry about anything in flepiconfig.