Adds README.

.pit/pit-a3f35d0d7925baa9

@@ -1,7 +1,7 @@
 [header]
 title = adding bibdata by hand
 id = a3f35d0d7925baa938852ab89477ef26964edf18
-status = open
+status = closed
 type = feature
 author = Fabien Benureau
 mail = fabien.benureau+git@gmail.com
@@ -9,6 +9,7 @@ date = 2012-10-05 at 14:59 UCT
 
 [eventlog]
 opened[0] = opened the 2012-10-05 at 14:59 UCT by Fabien Benureau
+closed[1] = closed the 2013-06-13 at 13:03(UCT) by Olivier Mangin
 
 [discussion]
 desc = # enter your description here

NOTES

@@ -1,3 +1,8 @@
+A paper correspond to 3 files :
+    name.pdf              a pdf or ps file, the paper itself, whose location is arbitrary
+    bibdata/name.bibyaml  a bibyaml file with all bibliographic data.
+    meta/name.meta        a metadata file for internal use, notes, citekeys, status, etc.
+
 + requires config file (default repo, open command, ...)
 - printing should include templating engine and several templates for bib types and output
   * chose existing engine

README

@@ -1,4 +0,0 @@
-A paper correspond to 3 files :
-    name.pdf              a pdf or ps file, the paper itself, whose location is arbitrary
-    bibdata/name.bibyaml  a bibyaml file with all bibliographic data.
-    meta/name.meta        a metadata file for internal use, notes, citekeys, status, etc.

README.md

@@ -0,0 +1,34 @@
+Papers brings your bibliography to the command line.
+
+Papers organizes your bibliographic documents together with the bibliographic data associated to them and provides command line access to basic and advanced manipulation of your library.
+
+Papers is built with the following principles in mind:
+
+ - all papers are referenced using unique citation keys,
+ - bibliographic data (i.e. pure bibtex information) is kept separated from metadata (including links to pdf or tags),
+ - everything is stored in plain text so it can be manually edited or version controlled.
+
+
+Notice: papers is still in early development and cannot be considered as stable
+
+
+Getting started
+---------------
+Create your library (by default, goes to '~/.papers/').
+
+    papers init
+
+Import existing data from bibtex (papers will try to automatically copy documents defined as 'file' in bibtex):
+
+    papers import path/to/collection.bib
+or for bibtex containing a single file:
+
+    papers add --bibfile article.bib --docfile article.pdf
+
+
+Authors
+-------
+
+ - Fabien Benureau
+ - Olivier Mangin
+ - Jonathan Grizou