From lawrence.michael at gene.com  Thu Feb  1 16:36:59 2018
From: lawrence.michael at gene.com (Michael Lawrence)
Date: Thu, 1 Feb 2018 07:36:59 -0800
Subject: [Rd] Fwd: Re: Best practices in developing package:
In-Reply-To: <B1ABA533-F827-4774-B9EE-DCBF607F9F73@rstudio.com>
References: <16a568f8-b467-57b8-04a6-46ecfac7ae63@mayo.edu>
 <943511$8qar09@ironport10.mayo.edu>
 <B1ABA533-F827-4774-B9EE-DCBF607F9F73@rstudio.com>
Message-ID: <CAOQ5NyefqSqo1LDV7ytfiempmKSGq8kAgvoybqo_Y1Q9zEo58w@mail.gmail.com>

Folding is a simple solution, but there are intrinsic problems, like the
need to embed the documentation in comments. If the user already has to
expand a fold to edit the docs, the IDE could instead just provide a link
or shortcut that jumps to a separate documentation file, written in
whatever language, Rd, markdown, docbook. For example, I could imagine
RStudio showing the rendered documentation in a side pane when the cursor
is on the function name/signature, and the user could somehow switch modes
to edit it. But there would be no need to mix two different languages in
the same file, and thus no ugly escaping, and no documentation obscuring
the code, or vice versa.

On Thu, Feb 1, 2018 at 7:20 AM, Lionel Henry <lionel at rstudio.com> wrote:

>
> > On 1 f?vr. 2018, at 06:51, Therneau, Terry M., Ph.D. <therneau at mayo.edu>
> wrote:
> >
> > A second is that I care a lot about documentation so my help files are
> > fairly long, so much so that the advantage of having the documentation
> of an argument
> > "close" to the declaration of said argument is lost.
>
> Good point. It suggests editors need folding support for roxygen sections.
>
> Lionel
> ______________________________________________
> R-devel at r-project.org mailing list
> https://stat.ethz.ch/mailman/listinfo/r-devel
>

	[[alternative HTML version deleted]]



[Rd] Fwd: Re: Best practices in developing package:
Michael Lawrence