[Pdl-devel] Fwd: Fwd: PDL release; I'm volunteering.

2019-06-11 Thread Diab Jerius
-- Forwarded message - From: Diab Jerius Date: Tue, Jun 11, 2019 at 9:51 AM Subject: Re: [Pdl-devel] Fwd: PDL release; I'm volunteering. To: Chris Marshall Sorry for the radio silence! We've had a wet spring in the Boston area and suddenly got nice weekend weather, which meant

Re: [Pdl-devel] PDL release; I'm volunteering.

2019-06-11 Thread Diab Jerius
On Fri, May 24, 2019 at 2:52 PM Ed . wrote: > > Just to be clear; you're saying that Perl (which seems quite nice) > illustrates the plus side of things being methods? Yes. My categorical statement was too broad. I'm not sure what the sweet spot is between ease of use and mandating a clean core

[Pdl-devel] RFC: Improving documentation

2019-06-11 Thread Diab Jerius
I recognize how hard documentation is to write, and I'm grateful that PDL has so much of it. However, there is room for improvement. The following comments are intended as an objective critique and to start a discussion which can lead to cohesive design and documentation standards. The current d

Re: [Pdl-devel] RFC: Improving documentation

2019-06-11 Thread Ed .
I think that moving away from POD is incompatible with sticking with metacpan.org. I would instead advocate: * reorganise docs as you've rightly said * stick with POD - I would also advocate using Inline::Pdlpp as I have with PDLA::IO::HDF::* - https://metacpan.org/source/ETJ/PDLA-IO-HDF-2.0191