Re: Where to add documentation details about jarray / registry?

Thanks for responding on that. I didn't know the answer off the top of 
my head (isn't it neat!), but thought you, James or Stefan might. I was 
once told jarray was not much used, meaning en route to deprecation, but 
until there is a compatible ndarray ... .

Ideally we whould have a set of documentation that is a copy of the 
CPython one with amendements. (And a web site to put it on.) But it's 
work. We might get away increasingly with referring to the CPython 
documents, because of increasing conformance to expectations created by 
CPython. It will never really reduce the need to zero, however. I don't 
know how affordably to maintain a large document that is only a little 
different from CPython's. I had a go with the dev-guide and think it 
saved work to borrow by forking, but it was still a fair amount of 
effort and not wholly successful in keeping up.

Language and module documentation has a different balance, though.

I think an approach that mimics CPython's structurally, but contains 
only notes about differences would work and a link to the CPython doc. 
It's a good reason to have a clearer answer to "what CPython are you 
most like" than we can normally give, since that's the version we would 
link. Where to put it though?

Jeff Allen

On 13/04/2019 12:53, Adam Burke wrote:
> There was a bug raised today which is already a feature, and really 
> just points to a documentation gap. I made a comment there, and was 
> going to add some doc, so went for the right place to enhance pages on 
> the jarray module. Basically I was expecting to add a few lines to a 
> page like this (which still turns up high on google)
>
> https://www.jython.org/archive/21/docs/jarray.html
>
> However it seems jython specific details like jarray or the jython 
> registry might have been victims of multiple documentation moves over 
> the years since v2.1. I started looking on the new jython doco git 
> project and moved out from there. There doesn't appear to be anything 
> on the wiki either.
>
> That all being what it is - can someone point me to either an existing 
> place to add to this, or where would the right place to add *back* a 
> page on jarray in the target documentation structure?
>
> Cheers
> Adam
>

_______________________________________________
Jython-dev mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/jython-dev