From ucfagls at gmail.com  Fri Jun  5 18:39:23 2015
From: ucfagls at gmail.com (Gavin Simpson)
Date: Fri, 5 Jun 2015 10:39:23 -0600
Subject: [Rd] NEWS.md support on CRAN
In-Reply-To: <CAOKDuOjWOBh-6z9ucdNQnN+mBKMb6DAcSsoGka1GcMJ=k4kExQ@mail.gmail.com>
References: <4819669E-8260-47B0-96BF-DC2B29E6BE21@me.com>
	<555FD2FE.8050600@gmail.com>
	<21856.13500.513608.759602@fangorn.hornik.net>
	<B98D36A9-901A-4413-88C0-22D7E923612E@me.com>
	<581D2C19-ED47-4D1D-8FC7-C4B4F368E637@gmail.com>
	<21868.18877.410651.592015@fangorn.hornik.net>
	<21869.50739.349239.728644@max.nulle.part>
	<556DCADA.7060109@gmail.com>
	<21870.40730.965705.219861@fangorn.hornik.net>
	<CAOKDuOhy=P8hYktkXJ2dtRexihc5vzsC44TUqn80j+Nz7oAoxg@mail.gmail.com>
	<CAAHES9y-ztcaK8uqbkR8vuYq4P3kmmJh3TS=Pp+81vSU2_22Xw@mail.gmail.com>
	<55708643.8020703@stats.ox.ac.uk> <557087EC.5020100@gmail.com>
	<CAAHES9zb76pGAG-1SrUS=Myqix7TPrMr0rMoMn-3r06qCj7=Ng@mail.gmail.com>
	<CAOKDuOjWOBh-6z9ucdNQnN+mBKMb6DAcSsoGka1GcMJ=k4kExQ@mail.gmail.com>
Message-ID: <CAAHES9xZRovyx1xqyaGC9V_c68mq8QBLDaDyN5sqAjvQsiAF2g@mail.gmail.com>

Mark,

As NEWS is not (yet) a required file for an R package on CRAN, we might do
well to encourage developers to provide that information. If moving with
the times means that more R package authors do that then I'll all for
allowing markdown. Many package authors do include markdown material
because github renders this nicely and those package authors are using
github because that suits them. If R can accommodate those developers and
at the same time encourage others to add this information, that's better
than having those developers deciding it's not worth their time to write a
NEWS file when they already include this information in github-specific
forms (release notes/messages), Issues, etc.

roxygen2 doesn't generate Rd markup, it just inserts the values of roxygen
tags into a pre-exising template (it may actually inject some Rd
boilerplate). You still need to write Rd markup in the values however.

Cheers

G

On 5 June 2015 at 00:53, Mark van der Loo <mark.vanderloo at gmail.com> wrote:

> @Gavin: My aim was to point out that the ability to mix developer-facing
> documentation with user-facing documentation is not a good reason to want
> to support md.
>
> I agree with Duncan that links to within a package would be useful (not
> sure if NEWS.Rd supports this).
>
> I'm not so convinced that package authors that do not even add a plain
> text NEWS file will create a NEWS.md file.
>
> Adding NEWS.md means we now have three ways to specify the NEWS:
>
> - a plain text NEWS file; following the GNU recommendations
> - NEWS.Rd
> - NEWS.md
>
> Would it not be more elegant to have e.g. roxygen2 generate NEWS.Rd?
> (perhaps it is already possible, I'm not sure of that). I don't maintain
> CRAN, but I know what I would prefer..
>
> Cheers,
> Mark
>
>
>
> ?
>
>
>


-- 
Gavin Simpson, PhD

	[[alternative HTML version deleted]]



[Rd] NEWS.md support on CRAN
Gavin Simpson