title: How to layout folders locally and in SVN when using eclipse
body: <p>I've been working with eclipse and SVN for many years in teams from a single developer up to 12 and I always was the one to setup our folder structure. I managed to get it working somehow, but I feel that my folder layout is far from optimal. It's hard to tell what my typical folder layout looked like, because it looked very different each time.</p>
  
  <p>I'm just starting another big project now, and I want to do it <em>the professional way</em> this time.</p>
  
  <h2>Facts about the project</h2>
  
  <p>Those are the facts right now:</p>
  
  <ul>
  <li>All developers will work with Eclipse</li>
  <li>Some will be using Subclipse to integrate SVN into Eclipse, others will use external clients like Tortoise SVN or svnX </li>
  <li>we're developing on Windows and Mac OS</li>
  <li>we're using ant to automate building and junit testing</li>
  <li>there will be multiple interrelated projects:
  
  <ul>
  <li>a library written in pure java, so it runs on all known java platforms</li>
  <li>several applications for several java plattforms (J2SE, J2ME, android...). All those applications depend on the library mentioned before</li>
  </ul></li>
  </ul>
  
  <h2>What to do with .project?</h2>
  
  <p>I'm alway unsure wether to commit those files generated by eclipse (like ''.project'' and ''.classpath''). In prior projects, sometimes we put them into the SVN, sometimes we didn't, and both approaches had ther pros and cons. Once, we even committed the whole workspace, but that seemed to be a bad idea.</p>
  
  <p>One key concept that I'm certainly missing is how Eclipse handles its workspace. By default, the whole project lies inside the workspace-folder, but there can be projects that are external, which are linked in some magic manner I just don't understand. </p>
  
  <h2>Possible folder layouts</h2>
  
  <p>I'm unsure how to layout the project locally <em>and</em> on the repository. I think there are three possibilities:</p>
  
  <ul>
  <li>the workspace is a subfolder of my local working copy (like c:\code\myWorkingCopies\projectXyz\trunk\workspace)</li>
  <li>my workspace IS my working copy (I use c:\code\myWorkingCopies\projectXyz\trunk\ as workspace)</li>
  <li>My workspace is somewhere (c:\code\workspace) and my working copy somewhere else (c:\code\myWorkingCopies\projectXyz\trunk) and I have those external projects</li>
  <li>any other ideas?</li>
  </ul>
  
  <h2>What kind of answer am I looking for?</h2>
  
  <p>A dummy folder structure, maybe something like that (do I just answer my own question?):</p>
  
  <ul>
  <li>trunk
  
  <ul>
  <li>projects
  
  <ul>
  <li>projectA</li>
  <li>projectB</li>
  </ul></li>
  </ul></li>
  </ul>
  
  <p>Along with a hint what to checkout where, like that:</p>
  
  <ul>
  <li>checkout trunk/projects to c:\code...)</li>
  </ul>
  
  <p>And some guidlines like</p>
  
  <ul>
  <li>never upload files of type x,y,z...</li>
  </ul>