refactor readme files: in r tests
ADD
tests/r/README.md
+# Overview of tests for the R buildpack
+
+## Tested configuration files
+
+- [`runtime.txt`](https://repo2docker.readthedocs.io/en/latest/config_files.html#runtime-txt-specifying-runtimes).
+- [`DESCRIPTION`](https://repo2docker.readthedocs.io/en/latest/config_files.html#description-install-an-r-package).
+- [`install.R`](https://repo2docker.readthedocs.io/en/latest/config_files.html#install-r-install-an-r-rstudio-environment).
+- [`requirements.txt`](https://repo2docker.readthedocs.io/en/latest/config_files.html#requirements-txt-install-a-python-environment)
+- [`apt.txt`](https://repo2docker.readthedocs.io/en/latest/config_files.html#apt-txt-install-packages-with-apt-get)
+
+## Test folders
+
+### r-rspm-apt-file
+
+- Test setup of the default R environment by omitting a version specification in
+ `runtime.txt`, where the date provided in `runtime.txt` is recent enough for a
+ RSPM snapshot of CRAN to be used.
+
+- Test use of a `apt.txt` file.
+
+### r-rspm-description-file
+
+- Test use of a `DESCRIPTION` file instead of an `install.R` file, where a
+ `runtime.txt` is omitted and a recent enough snapshot date is assumed a RSPM
+ snapshot of CRAN to be used.
+
+### r3.6-mran
+
+- Test setup of a R 3.6 environment by specifying `r-3.6-...` in `runtime.txt`,
+ where the date provided in `runtime.txt` is old enough for a MRAN snapshot of
+ CRAN to be used.
+
+### r4.0-mran
+
+- Test setup of a R 4.0 environment by specifying `r-4.0-...` in `runtime.txt`,
+ where the date provided in `runtime.txt` is old enough for a MRAN snapshot of
+ CRAN to be used.
+
+### r4.0-rspm
+
+- Test setup of a R 4.0 environment by specifying `r-4.0-...` in `runtime.txt`,
+ where the date provided in `runtime.txt` is recent enough for a RSPM snapshot
+ of CRAN to be used.

RENAME
tests/r/r-rspm-apt/apt.txt
tests/r/r-rspm-apt-file/apt.txt
RENAME
tests/r/r-rspm-apt/install.R
tests/r/r-rspm-apt-file/install.R
RENAME
tests/r/r-rspm-apt/runtime.txt
tests/r/r-rspm-apt-file/runtime.txt
RENAME
tests/r/r-rspm-apt/verify
tests/r/r-rspm-apt-file/verify
RENAME
tests/r/r-rspm-apt/verify.r
tests/r/r-rspm-apt-file/verify.r
RENAME
tests/r/r-rspm-apt/verify.sh
tests/r/r-rspm-apt-file/verify.sh
DELETE
tests/r/r-rspm-apt/README.rst
-R environment - install.R
--------------------------
-
-You can install an R, RStudio, and IRKernel environment with the following
-two files:
-
-* A ``runtime.txt`` file with the text::
-
- r-YYYY-MM-DD
-
- Where 'YYYY', 'MM' and 'DD' refer to a specific
- date snapshot of https://mran.microsoft.com/timemachine
- from which libraries will be installed.
-* An optional ``install.R`` file that will be executed by an R installation
- at build time. It can be used for installing packages from MRAN or GitHub.
-
-The presence of ``runtime.txt`` is enough to set up R, RStudio, and IRKernel. It
-uses the ``r-base`` package from the Ubuntu apt repositories to install
-R itself.

RENAME
tests/r/r-rspm-description/DESCRIPTION
tests/r/r-rspm-description-file/DESCRIPTION
RENAME
tests/r/r-rspm-description/NAMESPACE
tests/r/r-rspm-description-file/NAMESPACE
RENAME
tests/r/r-rspm-description/R/print_something.R
tests/r/r-rspm-description-file/R/print_something.R
RENAME
tests/r/r-rspm-description/verify
tests/r/r-rspm-description-file/verify
DELETE
tests/r/r-rspm-description/README.md
-# Test that `repo2docker` will build an R package
-
-If a `DESCRIPTION` file is present along with an `R`-requiring `runtime.txt`
-, repo2docker should build the R package that is in the repository.

refactor readme files: in r tests