title: Heroku and Github integration (how to structure the project)
body: <p>I'm creating a webservice and I want to store the source on github and run the app on heroku.  I haven't seen my exact scenario addressed anywhere on the 'net so far, so I'll ask it here:</p>
  
  <p>I want to have the following directory structure:</p>
  
  <pre><code>/project
    .git
    README &lt;-- project readme file
    TODO.otl &lt;-- project outline
    ... &lt;-- other project-related stuff
    /my_rails_app
       app
       config
       ...
       README &lt;-- rails' readme file 
  </code></pre>
  
  <p>In the above, project corresponds to <a href="http://github.com/myuser/project" rel="noreferrer">http://github.com/myuser/project</a>, and my_rails_app is the code that should be pushed to heroku.  Do I need a separate branch for the rails app, or is there a simpler way that I'm missing?</p>
  
  <p>I guess my project-related non-rails files could live in my_rails_app, but the rails README already lives there and it seems inconsistent to overwrite that.  However, if I leave it, my github page for the rails app will contain the rails readme, which makes no sense.</p>
  
  <p>Also ... I tried just setting it up as described above and running</p>
  
  <pre><code>git push heroku
  </code></pre>
  
  <p>from the main project folder.  Of course, heroku doesn't know I want to deploy the subfolder:</p>
  
  <pre><code>-----&gt; Heroku receiving push
   !     Heroku push rejected, no Rails or Rack app detected.
  </code></pre>