With How to create a MCVE we have a great help page for (new) users concerning how to produce a MCVE. However, the word "data" does not occur a single time.
Perhaps it is intended to keep it very general and it might be not that crucial in main programming languages, but at least in R I find it quite essential to provide a minimal toy data set with which the problem can be reproduced.
Maybe it's too obvious for experienced community users that a MCVE automatically should include data and, thus, this was overlooked so far?
R Example
I'm thinking especially of new R users who usually post some code that we hardly can use without data. Usually the community then reacts with "please add data" whereafter the OP e.g. provides data that is not a pleasure to copy-paste like this:
Var1 Var2 Var3
1 North America male 1970-01-01 01:00:01
2 Latin America male 1970-01-01 01:00:01
3 South America male 1970-01-01 01:00:01
4 North America female 1970-01-01 01:00:01
5 Latin America female 1970-01-01 01:00:01
6 South America female 1970-01-01 01:00:01
Furthermore, we do not yet know anything about the str
ucture of the data, if e.g. Var2
is of class "character"
or class "factor"
.
Often we can then also read "please add dput(yourData)
", which is better but fails if OP has huge data, also dput(head(yourData))
will fail if there e.g. are large groups. Besides, this method just misses the philosophy of an MCVE.
All in all, it's often a tedious debate until OP knows how to do it right and I have already skipped one or two such deficient questions.
Right now, I tend to send them both links, the MCVE and the How to make a great R reproducible example link. They are probably overwhelmed by two pages rich in content then.
Recommendation:
The providing of sample data, and also the best way to do so, should therefore be explicitly addressed on MCVE help page.
Option a) Maybe we could just insert a section like this:
Please also provide a minimal data set that others can use to reproduce your issue, see:
for SQL: Tips for asking a good SQL question
- for ...
or Option b), a little more succinct:
I would be happy if I could send them just a few words and the MCVE link, which explains the topic completely and compactly.
Please note that I criticize the complete absence of an explicit reference to MCVE-data. The tutorial links are only meant as a possible solution. If you agree with the proposal but only disagree about the content or length, show your preferred content
Provide all parts someone else needs to reproduce your problem in the question itself
- if data is required to repro the problem, it falls under the "complete" part. If the MCVE page were to cover every single aspect that could potentially be used to create a MCVE, the page would be unnecessarily massive