Fontana,
I'm somewhat confused by what you're doing with drafts in the
copyleft-next Git repository. I see you did most of the drafting on
0.3.1 as a copy of 0.3.0 in the file
Drafts/copyleft-next-0.3.1-SNAPSHOT, and the main Drafts/copyleft-next
has a separate history. The latter's text of it doesn't match 0.3.1 at
the moment, which seems odd and counter-intuitive given that you just
released 0.3.1. i.e., I was surprised at this:
$ git checkout -q v0.3.1 && diff -u Drafts/copyleft-next
Releases/copyleft-next-0.3.1 |diffstat
copyleft-next-0.3.1 | 433 +++++++++++++++++++++++-----------------------------
1 file changed, 196 insertions(+), 237 deletions(-)
... compared to previous release ...
$ git checkout -q v0.3.0 && diff -u Drafts/copyleft-next
Releases/copyleft-next-0.3.0 | diffstat
copyleft-next-0.3.0 | 5 ++---
1 file changed, 2 insertions(+), 3 deletions(-)
....where the only change was the release number and date, as expected.
ISTR that you and discussed a long time ago using tags and branches, and
keeping all drafting done in one single file was not what you wanted,
but I don't recall your reasons. Is that still what you want?
Regardless of how the repository is organized, the real problem is that
'git log' became a much less useful tool in figuring out the history of
copyleft-next between 0.3.0 and 0.3.1, and the project IMO has the
beginnings of some serious repository history bitrot.
I think the repository needs reconstruction to clean up this and other
problems I discovered today. I'd suspect this is would be 3-4 hour task
if done as a hackfest with a few people coordinated in real time on IRC.
I have various ideas on how we do it, and I have two separate proposals
for some basic repository disciplines that could be used going forward
to make sure we don't get this kind of history bitrot again.
Specifically, I have two parallel incompatible proposals that I'll pitch
if you're interested. The first would use the branch/tag structure I
proposed in the past, and reapply existing history. If you still don't
like that structure, I also devised in recent years a (complicated)
method that could keep your basic Drafts/ and Releases/ directory
structure on master branch and still preserve history properly.
But if you don't have time/interest right now in reengineering and
repairing the repository history, there is no need to have this broader
discussion. In that case, the minimal action that I request at this
time is to either update the docs or otherwise explain what file in
copyleft-next one ought to be looking at as the current draft, and some
documentation on how that relates to other files in the repository.
Once you clarify that, I can make a suggestion on future editing based
on my ideas above that can prevent future bitrot.
To make a strong plea for my point, though, I felt the whole reason to
do copyleft-next in the way that you did was to make the first truly
transparently designed license drafting project by using Free Software
development tools. Right now, the tools are being used but the
transparency is not complete.
--
-- bkuhn
========================================================================
Become a Conservancy Supporter today:
https://sfconservancy.org/supporter