I wish this forum had "Likes" like Facebook. Because Henry's post would get a big red Heart from me.
On Sun, Apr 29, 2018 at 12:42 PM, Henry Rich <[email protected]> wrote: > Last November I tried to start a project to document the Addons, and then > I dropped the ball. Raul contributed quite a bit as I recall. I find that > I am too busy with J Engine changes to take this project on. > > But we do need it. We need some place where a user can see what functions > are in the Addons so that they know what to download. After that, good docs > for each Addon would be nice but surely those are the authors' > responsibility. > > Python advocates point to the rich set of libraries as the main reason to > use their language. We should at least make the libraries we have easy to > search for. Anyone who takes on this project will be doing a great service > to J, and it doesn't take a J maven to do it, just someone who can organize > the information. > > > I read Ian's post as saying he himself doesn't NEED the docs. I expect he > would have good ideas on how to present the material to those who do need > it. Certainly in NuVoc he has written as much novice-level documentation > as anyone. > > Henry Rich > > > > On 4/28/2018 11:58 PM, Raul Miller wrote: > >> On Sat, Apr 28, 2018 at 8:55 PM, Ian Clark <[email protected]> wrote: >> >>> Now I'm not a novice user, and I have powerful tools, so nothing much >>> stops >>> me for long. So please don't offer to hold my hand in individual cases. >>> That misses the point. >>> >> The issue we need to solve is not so much declaring that we need >> better documentation, but writing better documentation. >> >> And that process needs both an author and an audience. >> >> But it seems like you are declaring, here, that you are offering to be >> neither? >> >> I might be a bit confused... >> >> > > --- > This email has been checked for viruses by AVG. > http://www.avg.com > > > ---------------------------------------------------------------------- > For information about J forums see http://www.jsoftware.com/forums.htm > ---------------------------------------------------------------------- For information about J forums see http://www.jsoftware.com/forums.htm
