X-Git-Url: https://git.openstreetmap.org./rails.git/blobdiff_plain/06f3473d1c64d2e0a1ecc6f1a9c4679a52bc4761..1472a165168815277351a4091c7b05d136d3c316:/doc/README_FOR_APP?ds=sidebyside

diff --git a/doc/README_FOR_APP b/doc/README_FOR_APP
index ac6c14912..1e76e610b 100644
--- a/doc/README_FOR_APP
+++ b/doc/README_FOR_APP
@@ -1,2 +1,45 @@
-Use this README file to introduce your application and point to useful places in the API for learning more.
-Run "rake appdoc" to generate API documentation for your models and controllers.
\ No newline at end of file
+This is the OpenStreetMap rails server codebase. Documentation is currently
+extremely incomplete. Please help by writing docs and moving any SQL you
+see to use models etc.
+
+=INSTALL
+
+Full information is available at 
+http://wiki.openstreetmap.org/wiki/Rails
+
+* Get rails working (http://www.rubyonrails.org/)
+* Make your db (see db/README)
+* Install ruby libxml bindings:
+    sudo apt-get install libxml-ruby1.8 libxml-parser-ruby1.8
+* Install ImageMagick libraries & ruby gem:
+    sudo apt-get install libmagickcore-dev
+    sudo gem install rmagick
+* Install primary keys plugin for active record (minimum version 0.9.1)
+    sudo gem install composite_primary_keys
+* Make sure you have a MTA listening on localhost:25 if you want mail
+    sudo apt-get install exim4
+* Start the server
+    script/server
+* Thats it
+
+=API CHANGES FOR EDITOR AUTHORS
+
+See
+
+The information about the next version of the protocol API 0.6 is available at 
+http://wiki.openstreetmap.org/wiki/OSM_Protocol_Version_0.6
+http://wiki.openstreetmap.org/wiki/REST
+
+=HACKING
+
+* Log in to your site (proably localhost:3000)
+* Create a user and confirm it (by setting the active flag to true in the users table of the database
+* You want to play with the API (probably at http://localhost:3000/api/0.6/node/create etc)
+* Lots of tests are needed to test the API. To run the tests use 
+    rake test
+* Lots of little things to make the site work like the old one.
+
+=Bugs
+
+See the 'rails_port' component for bugs:
+http://trac.openstreetmap.org/query?status=new&status=assigned&status=reopened&component=rails_port&order=priority