Skip to content
Matt Dowle edited this page Dec 9, 2017 · 33 revisions

When asking for free support please keep in mind that this software is written and supported by other users like you. Often it is written and supported in evenings and weekends. If you show that you have respect for our time you will get a much better response. In time, we hope that like us, you will progress to start fixing and improving the software yourself.

  1. Search NEWS which is updated live as bugs are fixed or features are added. Many people fail to do this. If you have searched NEWS then state that you have! That saves us time in searching it ourselves. If there's a chance the latest version in dev fixes the issue, then install dev and try it. A pre-compiled binary for Windows is made after every change in dev so you don't need any tools.

  2. Thoroughly search Stack Overflow's [data.table] tag. In the top right of the screen type in the search box "[data.table]" followed by the actual error message. Yes, copy and paste the actual error message (or the most salient parts from it) since the error message will appear in the text of good questions. If you get no results then you could try the "[r]" tag in case a question has been asked about that error message but not tagged data.table. If so, please edit that question and add [data.table] alongside the [r] tag if and only if the question (not the answer) was about data.table. See S.O. search tips.

  3. Provide the output of sessionInfo() up front. This tells us your operating system, the version of R and the version of data.table. Many people fail to do this even after years and years of asking over and over again.

  4. Provide a minimal and reproducible example: how to make a great R reproducible example. Providing one should be possible in almost all cases.

  5. If you don't know how to do something, state what you've tried already; e.g., which search strings precisely did you try, what is your input and what is your desired output.

  6. Be sure to tag the question both [r] and [data.table] otherwise it won't be seen by those watching the tag.

Please DO NOT contact a project member directly (e.g. using email or twitter), UNLESS :

  • you have already raised a question on [data.table] or raised an issue on Github and the solution or progress is unsatisfactory. In this case include a link to the question or issue and why you are bringing it to our attention. We welcome such emails or tweets.
  • you are unable to raise a public question or issue (please tell us why not) or require enterprise support.

Further tips

  1. How to ask
  2. How to ask questions the smart way
  3. R posting guide
  4. Github flavoured markdown (for formatting your code)
  5. Exclude the prompt > from the code in your question. Including it means it won't work when we copy and paste it to our prompt. Use "#" to comment the output parts.
  6. What is the intended behaviour? And what do you get instead? Show the output. If you get a warning or an error message, be sure to include the full message in your question otherwise nobody can confirm they have reproduced the same error or warning that you get.
  7. Turn on verbose mode with verbose=TRUE passed to the function or turn on the global option with options(datatable.verbose=TRUE).
  8. Provide an external link to the minimal reproducible file and use that file name in your code.
  9. Look at closed issues. Observe the good and the bad.
  10. Type ?data.table and look at all the arguments. Do you know them all? For example, do you know which= and others? Make sure you do. It is likely that one of them is there for your task. If some seem like they could help, search Stack Overflow for that argument name within the [data.table] tag and see how people have used it. Many answers use data.table but the question was not about data.table, so in this situation search in the [r] tag (not [data.table]) for the "data.table" and the argument name.
  11. Read all the vignettes.
  12. Read all the questions in the data.table FAQ even if you don't have those questions yet.
  13. Take the Datacamp course

Best wishes!