<div class="markdown">
<p dir="auto">If you're working on an idea for Swift, you've probably already spent a lot of time thinking deeply about it. Working with other people in the community to further develop your idea is wonderful, and by the time we're all reviewing the code, it's really important that we all think deeply about the problem and proposed implementation. The challenge is figuring out how to share this information so we can all benefit from the time you've already spent thinking about it. When we're all in the same room, it's easy--we just grab a whiteboard and take some time. But when we're globally distributed, that's hard.</p>

<p dir="auto">Previously, we've tried to use the swift-specs repo as a place to share this "brain dump" and collaborate on an idea. However, specs-as-code-review has some problems:<br>
    * spec review distracts from code review<br>
    * spec review devolves into bikeshedding at the earliest opportunity<br>
    * typos are not what's important in a spec<br>
    * specs take a long time to land (in part because of the above)<br>
    * once specs have landed, it becomes much harder to ask questions and have a conversation about the idea<br>
    * where there's some disagreement, no progress is made</p>

<p dir="auto">The swift-specs repo has become a wasteland of partial ideas where hope goes to die.</p>

<p dir="auto">Moving forward, we want to facilitate communication without encouraging despair. We will be stopping any further work in the swift-specs repo. It is, as of now, officially dead.</p>

<p dir="auto">To replace the "shared brain dump" area, we have <a href="https://wiki.openstack.org/wiki/Swift/ideas">https://wiki.openstack.org/wiki/Swift/ideas</a> where you can add</p>

<pre><code> Topic -- link to your document
</code></pre>

<p dir="auto">That's it.</p>

<p dir="auto">Currently-open patches to the swift-specs repo have been landed so they can be accessed through the <a href="http://specs.openstack.org">http://specs.openstack.org</a> site. If you write down your thoughts and want to share them so others in the community can help you write and merge it, add a line to the wiki page. It doesn't matter where you write down your thoughts. Use whatever you want. Etherpads, wikis, google docs, slide decks, anything. Use what works for you, and please include some contact info in your doc (IRC nick, email, etc). I'm looking forward to reading what you're thinking about and working with you to implement it.</p>

<p dir="auto">--John</p>

</div>