Good documentation

There is a great blog post entitled What nobody tells you about documentation which discusses what makes good documentation. Reading it made me realize why I like using R so much. Not only does it have great documentation but it follows many of the points listed in the above link. Every time I use the documentation in R I invariably learn something new or make some connection which had escaped me in the past.

R’s documentation

One of the primary reasons R is my favorite tool is its help system.  R’s help system is invoked by using the `?` command!  For e.g., if I want to learn about `lm` (linear model) I just type ?lm in the session and it will open up the help related to that function.  The most effective way of using R’s help system is to learn how to use it.  This is how I go about it:

  • Read the Description which is at the start of the page.  It generally lists the mnemonic that might help you remember the command.  For e.g., `lm` stands for linear model, `str` stands for *str*ucture of an R object.  Becoming aware of the mnemonic makes it easier to remember and recollect it later.
  • Briefly skim the Usage section.  See the various ways in which the function can be called and how it can be used.  Don’t worry about it too much if it doesn’t make too much sense at the moment.
  • Scroll all the way to the bottom of the help system which generally contains the Examples section.  Read the examples and literally type them in your R console to learn what the function does.  You can also use the `example` function to run all the code in the Examples section automatically.  Typing example(str) in your R console will run the examples for the `str` function.
  • Now scroll back up to the Usage section again and you will be able to make a lot more sense of what a particular function is doing.
  • Now slowly read the Details section to understand the details of this function.  This is the most thorough portion of the documentation! As you get proficient you will be able to grok this section easily and gain deeper insights about this function.
  • Now scroll to the Examples section and just above it is the See Also section.  This section lists all the functions/commands/options that are somehow related with the current function that you are learning about. Consistently exploring the recommendations made in the See Also section is the surest way to improve your proficiency in R.

The brilliance of R’s documentation system is that it aids in most of the different tasks mentioned in the link above.  The brief Usage section at the top of the documentation page and the Examples section at the end of the page give you a self-contained Tutorial and a How-to guide!  The Details section provides the Explanation about the function and all its input parameters whereas the Value section explains the output of the function. The See Also section shows how this topic is related with other similar topics which helps in learning how this function fits into the R environment.  All these various sections not only aid in your data exploration but helps you in getting a better understanding of the R environment and the tools it provides.

5 thoughts on “Good documentation

  1. Jachodo

    Canine Cephalexin Side Effects Abdominal Pain Mebendazole [url=]cialis price[/url] Buy Z Pak No Prescription Finasteride Nausea Propecia Medrol 4 Kopen

  2. Miliansgef

    Surrogacy is very renowned in different countries. The primary argue of it – a wifes become the arrival child’s mother after childbirth. A lot of woman would be a mommy, but any of them haven’t possibility.

    By this reason in last years a new term emerged – surrogate.
    When pregnancy is medically impossible, there is only one method to be a mother. It is surrogacy. Also, in these cases use monetary indemnity.

    Really, to search a healthy girl – needed to find medical support which grant this kind of service.
    We advice to apply for this [url=]sargent mother[/url] company. In these center in Ukraine a lot of womant from USA, United Kingdom and different E.U. regions became surrogate mothers.

    Therefore to the laws surrogacy is lawful. The legality and expenses of surrogacy are very various. It depends from location, creed, color of hair, etc. In our clinics you can make a selection about kind of surrogate.

    We recommend for all our members to take traditional surrogacy. But our serve hold gestational surrogacy. In Feskov agency are designation for surrogacy.

    When you go on to our clinic based in Ukraine – a part of Feskov Human Reproduction Group, you received a consultant. This administrator will consult you about various things from the start till the end. However, surrogacy continues 7 months. Then the administrator prepares all needed acts and you can take the child.

    As rule, the administrator receive information your family next months. It you need to obtain a child, we advice to go there Managers which are able to help there are very clever. They will answer for all your requests. If you needed any advice, they will help you.

    Also they will gave contract before this process.
    On web-site you can find datas. As rule you can detect prices and packages. Tech can help you at Russian. You can make select of it.

    If you would be able to obtain advise about mother surrogate as a process, A.Feskov will gave advice for you.

Comments are closed.