Re: [Jython-dev] Maintaining the Definitive Guide to Jython

[Jeff A. <ja...@fa...>]

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
> jun...@gm... <mailto:jun...@gm...>
> http://jj-blogger.blogspot.com <http://jj-blogger.blogspot.com/>
> https://www.apress.com/us/search?query=Juneau
>
> On May 6, 2019, at 5:06 PM, Jeff Allen <ja...@fa... 
> <mailto:ja...@fa...>> 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 <ja...@fa... 
>>> <mailto:ja...@fa...>> 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
>> Jyt...@li... 
>> <mailto:Jyt...@li...>
>> https://lists.sourceforge.net/lists/listinfo/jython-dev