Improve README.md about git-darcs HOT 3 CLOSED

Hi Joy

Hey, I expected to see installation instructions, maybe a pointer to contributing, and an explanation of the short description "Incremental import of git into darcs and back again". What I find is a tutorial using unexplained terms and repos and folders. It's hard to tell what the point is, despite the Why section. A key missing piece is the "back again" part.

Documentation in definitely not my strong skill and I'd be glad to improve it.

Why use two VCSs?

At work everything has to end-up in git and also git scales much better in terms of storage and retrieval time. So my workflow is:

1. Check-out the git repo I have to work with
2. Snapshot the latest commit into darcs
3. Craft my patches: I will amend a lot and use the excellent capabilities of darcs to move code between patches, to create very consistent and clean patches
4. I will use git darcs pull to bring the darcs-patches back into git and create pull-request

Perhaps you could put some standard stuff in readme.md with a link to tutorial.md or something?

https://github.com/ganwell/git-darcs#Tutorial

At least mention the required version of Python?

It is tested with python 3.8+. I'll add that to the readme.

from git-darcs.

I extended the README.md

from git-darcs.

Thanks, that's a little better.

from git-darcs.