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
