<p>Based on discussions at EWG, it was decided to move the setup documentation into the repository. This PR features:</p>
<ul>
<li>Reviewed, tested and reworked installation notes</li>
<li>Splitting contribution-related materiel into CONTRIBUTING.md</li>
<li>Post-installation optional configuration steps in a separate (cross-platform) CONFIGURATION.md file</li>
<li>Removal of some crufty bits of the old wiki docs</li>
</ul><p>It doesn't include:</p>
<ul>
<li>Platform-specific installation notes. MacOSX and Fedora are anticipated</li>
<li>Clarification by renaming the databases (to osm-development etc) - for a future PR, perhaps</li>
</ul><p>If this PR is merged, then I will remove the stale documentation from the wiki and leave pointers to these in-repo documents.</p>
<hr>
<h4>You can merge this Pull Request by running</h4>
<pre> git pull https://github.com/gravitystorm/openstreetmap-website docs</pre>
<p>Or view, comment on, or merge it at:</p>
<p> <a href='https://github.com/openstreetmap/openstreetmap-website/pull/317'>https://github.com/openstreetmap/openstreetmap-website/pull/317</a></p>
<h4>Commit Summary</h4>
<ul>
<li>Start a contributing file based on content from the README</li>
<li>Revise the readme.</li>
<li>Call it UTC not GMT to reduce timezone confusion.</li>
<li>Start the INSTALL.md with a big dump of the wiki information.</li>
<li>Start rewriting install notes.</li>
<li>Remove vendorer (now in Gemfile) and osmosis (it's optional) from minimum requirements.</li>
<li>Start inlining the dependency information. But the stuff on the wiki is almost all wrong.</li>
<li>The condensed version of installing the gems.</li>
<li>Remove the stuff on populating the database, since this should be taken care of by a rake task.</li>
<li>Remove this - 1.3.1 was released in 2008, and would be ensured by following the prerequists anyway.</li>
<li>Remove code editing suggestion.</li>
<li>Convert and simplify more installation instructions.</li>
<li>Rewrite more database setup instructions.</li>
<li>Quick reworking of the users section.</li>
<li>Fix link.</li>
<li>Remove the GPX, high-speed GPX and CGIMap stuff.</li>
<li>Quickly fix markdown for the rest of the file.</li>
<li>Remove info that's repeated elsewhere.</li>
<li>Linkify to other files.</li>
<li>Add more external links.</li>
<li>Tweak intro.</li>
<li>Remove the osmosis dependency, which isn't required for all development activities.</li>
<li>Remove the hardcoded postgresql server headers version - it's dealt with later in the file.</li>
<li>Nobody does this, so it's not useful installation information.</li>
<li>Write notes on production.</li>
<li>Tweaks.</li>
<li>Ignore the generated docs.</li>
<li>Move the development-related miscellanea to CONTRIBUTING.md</li>
<li>Add missing dependencies, and wrap for better presentation.</li>
<li>Actually create the databases at some point!</li>
<li>Alter the example db config to use socket connections - these are enabled by default on Ubuntu.</li>
<li>More database-related tweaks.</li>
<li>Remove the database creation code, which is covered further up by rake db:create</li>
<li>Tests work without manual btree_gist installation, so happy days.</li>
<li>Found a package that depends on whichever postgresql-server-dev-X.X is required. Simplifies notes.</li>
<li>More copy.</li>
<li>Generalise the OAuth instructions now that we need three keys.</li>
<li>Neither of these are correct - the warning appears if you haven't restarted the app, and the icons do appear fine.</li>
<li>Tweaks.</li>
<li>Move configuration to seperate file.</li>
<li>Rephrase note about parser errors</li>
<li>Add and explain choice based on repository size. Closes #1.</li>
</ul>
<h4>File Changes</h4>
<ul>
<li>
<strong>M</strong>
<a href="https://github.com/openstreetmap/openstreetmap-website/pull/317/files#diff-0">.gitignore</a>
(1)
</li>
<li>
<strong>A</strong>
<a href="https://github.com/openstreetmap/openstreetmap-website/pull/317/files#diff-1">CONFIGURE.md</a>
(117)
</li>
<li>
<strong>A</strong>
<a href="https://github.com/openstreetmap/openstreetmap-website/pull/317/files#diff-2">CONTRIBUTING.md</a>
(99)
</li>
<li>
<strong>A</strong>
<a href="https://github.com/openstreetmap/openstreetmap-website/pull/317/files#diff-3">INSTALL.md</a>
(176)
</li>
<li>
<strong>M</strong>
<a href="https://github.com/openstreetmap/openstreetmap-website/pull/317/files#diff-4">README.md</a>
(147)
</li>
<li>
<strong>M</strong>
<a href="https://github.com/openstreetmap/openstreetmap-website/pull/317/files#diff-5">config/example.database.yml</a>
(6)
</li>
</ul>
<h4>Patch Links:</h4>
<ul>
<li><a href='https://github.com/openstreetmap/openstreetmap-website/pull/317.patch'>https://github.com/openstreetmap/openstreetmap-website/pull/317.patch</a></li>
<li><a href='https://github.com/openstreetmap/openstreetmap-website/pull/317.diff'>https://github.com/openstreetmap/openstreetmap-website/pull/317.diff</a></li>
</ul>