cordova-docs icon indicating copy to clipboard operation
cordova-docs copied to clipboard

Import history of Cordova website artifacts

Open brody4hire opened this issue 5 years ago • 4 comments

Many, many, many files were added in PR #395 to merge an old cordova-website repository with this one, with zero history of the files that were added. This made it especially hard to understand the history behind the ZeroClipboard library that we discovered in issue #1031 and removed in PR #1032.

I was able to get some history of cordova-website from svn: https://github.com/apache/cordova-docs/blob/master/doc/deploying-the-website.md#manual-deployment

I don't know if svn should be considered the original source of the history or not.

/cc @dblotsky

brody4hire avatar Dec 12 '19 17:12 brody4hire

I totally forgot about SVN. Yes, that is the history you’re looking for. It is where the website was before merging it into cordova-docs.

dblotsky avatar Dec 12 '19 18:12 dblotsky

Thanks @dblotsky for confirming.

Here is what I did to look through the history of cordova-website, starting from the beginning:

svn checkout https://svn.apache.org/repos/asf/cordova/site cordova-website
cd cordova-website
svn log -r 1:HEAD -v | more

I think we should try to import this history into git.

brody4hire avatar Dec 12 '19 19:12 brody4hire

Is the history import worth the effort? I would pit it against the effort of finding answers without history.

IMO there are few enough files in this repo that just spelunking through them can give you answers without the SVN history.

dblotsky avatar Jan 19 '20 20:01 dblotsky

I think the most important reason for preserving the history is to help people understand the context of things in the future. The prime example I gave was in removing the obsolete ZeroClipBoard library in PR #1032. We can see in PR #1032 that it broke something else in #1047. I think it is also good practice to preserve traceable authorship of our code from an IPR perspective.

I am fine to just keep that old history in svn for now, at least. You should see that I just added a note to PR #395 where the files were imported.

brody4hire avatar Jan 20 '20 15:01 brody4hire

Closing out this ticket.

While I understand the importance of preserving history, I personally have not found the need to access the SVN history in the past.

I believe it is unnecessary to migrate the history. It is still retrievable in SVN if someone dos need it.

erisu avatar May 31 '23 06:05 erisu