Re: Maintaining the Definitive Guide to Jython

Hi Jeff,

Thanks for sending.  I'm not sure why that particular file was checked into
the repository.  It is a generated file from Sphinx, and I think it will be
recreated when rebuilt.  I do not believe that you will lose anything by
discarding.

I like your idea of adding a "How to Build This Book" section to the readme.

Thanks!

On Tue, May 7, 2019 at 1:49 AM Jeff Allen <[email protected]> wrote:

> Thanks Josh. I understand that you may not be able to help with writing.
> In fact, I'm not sure yet how much we shall do ourselves, but it seems good
> to have the book as a living repository, and it is one place we can explain
> our differences from CPython.
>
> One thing you may be able to clarify ... At some point you checked in the
> generated html (
> https://github.com/jython/book/commit/e41a8089404e8da518294b46523bce516c9f21a6)
> but it is now behind the published state of the book. Do we lose anything
> if we discard this?
>
> So far I only spot the title change and an empty chapter 16 "Web Services
> and SOA". I wouldn't normally check in a build product, although I was
> thinking of adding a "how to build this book" to the readme.
>
> Jeff
>
>
> Jeff Allen
>
> On 06/05/2019 23:55, Josh Juneau wrote:
>
> Hi Jeff/Jim,
>
> I'm very happy to see that the Jython book will be updated!  I don't
> personally have time to help right now but I'm definitely on-board with the
> book being moved forward.
>
> Thanks for all of your time and effort.
>
> Josh Juneau
> [email protected]
> http://jj-blogger.blogspot.com
> https://www.apress.com/us/search?query=Juneau
>
> On May 6, 2019, at 5:06 PM, Jeff Allen <[email protected]> wrote:
>
> Hi Jim,
>
> it's always good to hear that no further admin is necessary. I'll happily
> accept that covers contributions via GitHub, which is probably all.
>
> As GitHub users may not remember theis from the T&Cs they signed up to (I
> didn't), something in the readme/contributing would be good, referencing
> the license and this term already accepted. (I realise the license is on
> the index page.)
>
> Jeff
>
> Jeff Allen
>
> On 06/05/2019 18:44, Jim Baker wrote:
>
> Jeff,
>
> Thanks for bringing this up! It would be great for this book to be updated
> with PRs, which is why we licensed it under CC-SA, wrote it using a source
> text approach, and placed it under repo management.
>
> We also currently have assent support for any PRs per GitHub terms of
> service:
>
> https://help.github.com/en/articles/github-terms-of-service#6-contributions-under-repository-license
>
> (See more here:
> https://ben.balter.com/2018/01/02/why-you-probably-shouldnt-add-a-cla-to-your-open-source-project/
> )
>
> So really there's nothing more to be done on the admin side, as I see it.
>
> - Jim
>
> On Sun, May 5, 2019 at 9:14 AM Jeff Allen <[email protected]> wrote:
>
>> We have a few pull requests against the Jython book in GitHub, and some
>> interest in seeing it updated. The authors hold a copyright, but released
>> it under a Creative Commons 3.0 CC-BY-SA Licence. It publishes
>> automatically via ReadTheDocs. https://jython.readthedocs.io
>>
>> One clear thing is that a modified version must also be released under
>> the same license. Contributors have to assent to that somehow, and this has
>> nothing to do with the license under which the Jython code base is
>> released, or the PSF contributor form. I'm wondering what that assent
>> consists of, and how we keep a record.
>>
>> I found this helpful:
>> https://wiki.creativecommons.org/wiki/Best_practices_for_attribution in
>> forming an idea of what the intention is.
>>
>> The stuff about re-use and derivative works does not perfectly fit the
>> case of publication from a repository, but I think closely enough if one
>> regards the state handed down as an "original" and any current state as
>> either "modified slightly" (after a simple bug-fix) or a "derivative"
>> (after adding a new chapter). The record of change in the repository will
>> do, I think, as a description of who authored what change. Almost
>> everything asked for by CC as attribution is supplied by the context, given
>> the change is *in* the repository.
>>
>> I've seen it suggested each commit/patch should contain a label
>> signifying assent. Elsewhere I've seen a requirement to add oneself to a
>> contributors file, in which could assert the license at the top. It's
>> hardly unforgeable, but evidence of a sort if need be, which it probably
>> never will. Does either of these seem reasonable to us to ask people?
>> Thoughts?
>>
>> Jeff
>>
>> --
>> Jeff Allen
>>
>> _______________________________________________
> Jython-dev mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/jython-dev
>
> --
Josh Juneau
[email protected]
http://jj-blogger.blogspot.com
https://www.apress.com/us/search?query=Juneau
<https://www.apress.com/index.php/author/author/view/id/1866>

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