This is the GitHub repo for the Stata2R website: https://stata2r.github.io.
You probably want to go directly to the website if you just want to browse the
rendered pages with nice formatting. On the other hand, if you want to raise an
issue or suggest edits via a pull request, then you're in the right place. For
suggested edits, the main source documents of interest can be found in the
respective src/ sub-directories:
Just click on the "edit" pencil icon (top right) of the README files and a fork of the repo will automatically be created under your account. You can then make your suggested edits and trigger a pull request for us to look at.
On a technical note, the website is built with VuePress and automatically deployed via GitHub Actions. But you can also clone the repo and serve the website locally with yarn.
git clone git@github.com:stata2r/stata2r.github.io.git
cd stata2r
yarn install # first time only
yarn docs:devWho are you?
- The initial website is a collaborative effort between Kyle Butts, Nick Huntington-Klein, and Grant McDermott. We're hoping that it won't take much maintenance from hereon out, but welcome outside contributions and suggestions.
Why did you make Stata2R?
- The short answer is that we have been asked for this kind of resource many (many) times, and didn't feel any of the existing options quite fit the bill. The longer answer is we've all been through the frustrations (and joys) of learning a new language and want to lower the barrier-to-entry for R, specifically. There's an unfortunate belief among some Stata users that R is somehow simultaneously complex and lacking. (And perhaps the same could be said in reverse.) As in, it's supposedly hard to do simple things and unable to do hard things. This view is quite obviously mistaken. But sometimes it takes seeing simple side-by-side examples to get someone on their way. There are some important differences between the languages, but you should be able to do pretty much whatever you want without too much hassle.
Do you think Stata users should just switch to R?
- No. The future is multilingual and we support people using what they want. At the same time, R does have some obvious advantages in terms of price (free) and performance, which make it attractive for a variety of use cases. We hope that this website provides researchers, teachers, students, and professional with some additional options should they choose to use them.
The materials in this repo (and associated website) are made available under the MIT License.