title: Where is the fundamental documentation on AppScale?
body: <p>On the <a href="http://www.appscale.com/">AppScale</a> homepage there is a link to their <a href="https://github.com/appscale/appscale/wiki">Documentation page</a>. However, this page only holds documentation about</p>
  
  <ol>
  <li>How to <em>install</em> AppScale</li>
  <li>An "Advanced" section about how to handle various specific stuff.</li>
  </ol>
  
  <p>I find it somewhat arbitrarily structured, but more importantly: I fail to see where all the fundamental documentation is. Is it just poorly structured, or is it actually absent? For example, I have failed to find the following:</p>
  
  <ul>
  <li>What is the basic architecture of AppScale? How does it work, really? (Besides that it resembles GAE)</li>
  <li>How do I upgrade AppScale once it has been installed in a production environment? Can I do it iteratively, one machine at the time? I guess having a cluster with multiple versions of AppScale (and related services) can lead to problems. </li>
  <li>Is AppScale "just" (nothing negative about "just") a collection of programs/services (DB, webserver, cache, etc.), bundled with a nice web-GUI front end for easy management? Or are there more to it?</li>
  <li>How do I configure it so the configurations are consistent across all virtual machines?</li>
  <li>Where do I find more information about how the load balancer works? Exactly what service's load is it balancing? And how? </li>
  <li>How do I configure, for example, the Cassandra database? Is it just to configure Cassandra as I would normally do, unrelated to AppScale?</li>
  <li>The IP addresses I specify in the AppScale config, exactly in which way do they relate to the services? Are they the "just" AppScale's access points to the respective services, or are they actually channeled somehow to these services to become a part of <em>their</em> configuration?</li>
  <li>And the list goes on...</li>
  </ul>
  
  <p>In short, I really miss some documentation about how AppScale works, how everything is wired up, and how I am supposed to work with it. Perhaps I am just looking all the wrong places?</p>