97 lines
4.5 KiB
Markdown
97 lines
4.5 KiB
Markdown
# Diaspora
|
|
[](http://travis-ci.org/diaspora/diaspora)
|
|
|
|
[](https://gemnasium.com/diaspora/diaspora)
|
|
|
|
The privacy aware, personally controlled, do-it-all, open source social
|
|
network.
|
|
|
|
[Diaspora Project](http://diasporaproject.org)
|
|
|
|
**TL;DR**
|
|
|
|
## Are you a user?
|
|
You can get an account on any Diaspora pod(http://podupti.me or http://dspr.tk/a for a list of pods), or sign up for an invite
|
|
at the pod run by the original development team at https://joindiaspora.com
|
|
|
|
## Are you a developer?
|
|
|
|
Read on for how to get started.
|
|
|
|
**THIS IS ALPHA SOFTWARE AND SHOULD BE TREATED ACCORDINGLY.**
|
|
**IT IS FUN TO GET RUNNING, BUT EXPECT THINGS TO BE BROKEN.**
|
|
|
|
## Want an invite?
|
|
|
|
Diaspora is decentralized. You don't need an invite to joindiaspora.com to fully participate. Just choose your pod for example at http://podupti.me or http://dspr.tk/a If you still want one have a look at https://github.com/diaspora/diaspora/wiki/Invitations Or setup your own pod
|
|
|
|
Even if you're not a programmer, we'd love for you to give Diaspora a spin; all suggestions and comments welcome!
|
|
|
|
|
|
## Installation instructions
|
|
|
|
Installation instructions are [here](http://github.com/diaspora/diaspora/wiki/Installing-and-Running-Diaspora).
|
|
|
|
Thanks for helping battle test Diaspora.
|
|
Please report any bugs you see at [GitHub Issues](https://github.com/diaspora/diaspora/issues).
|
|
|
|
## Contributing to Diaspora
|
|
|
|
###[An introduction to the source code](http://github.com/diaspora/diaspora/wiki/An-Introduction-to-the-Diaspora-Source)
|
|
###[Issue tracker (bugs and features)](https://github.com/diaspora/diaspora/issues)
|
|
###[How to use git](http://github.com/diaspora/diaspora/wiki/Git-Workflow)
|
|
|
|
Here are a few good places to start:
|
|
|
|
- Run "rake spec" to run our [Rspec](http://blog.davidchelimsky.net/2007/05/14/an-introduction-to-rspec-part-i/)
|
|
unit test suite.
|
|
|
|
- Run "rake cucumber" to run our [Cucumber](http://rubylearning.com/blog/2010/10/05/outside-in-development/)
|
|
integration test suite.
|
|
|
|
- Take a look at the [issue tracker](https://github.com/diaspora/diaspora/issues) and pick a bug.
|
|
Write a spec for it, so it's easy for another developer to fix it.
|
|
|
|
Catches must be tested, and all your tests should be green,
|
|
unless you're marking an existing bug, before a pull request is sent.
|
|
Unit tests should be in Rspec, and integration tests should be in Cucumber.
|
|
|
|
Please make your changes in a branch to ensure that new commits to your master are
|
|
not included in the pull request, and to make it easier for us to merge your commits.
|
|
|
|
Please do not rebase our tree into yours.
|
|
See [here](http://www.mail-archive.com/dri-devel@lists.sourceforge.net/msg39091.html)
|
|
for when to rebase.
|
|
|
|
We need you to fill out a
|
|
[contributor agreement form](https://spreadsheets.google.com/a/joindiaspora.com/spreadsheet/viewform?formkey=dFdRTnY0TGtfaklKQXZNUndsMlJ2eGc6MQ)
|
|
before we can accept your patches. This dual license agreement allows
|
|
us to release limited pieces of Diaspora under the MIT license. You can find it
|
|
[here](https://spreadsheets.google.com/a/joindiaspora.com/spreadsheet/viewform?formkey=dFdRTnY0TGtfaklKQXZNUndsMlJ2eGc6MQ).
|
|
|
|
## Resources
|
|
|
|
Here is our [bug tracker](https://github.com/diaspora/diaspora/issues) and our
|
|
[roadmap](https://github.com/diaspora/diaspora/wiki/Roadmap). Also, you can
|
|
find see what the core team is up to [here](http://www.pivotaltracker.com/projects/61641).
|
|
|
|
|
|
Ongoing discussion:
|
|
|
|
- [Diaspora Developer Google Group](http://groups.google.com/group/diaspora-dev)
|
|
- [Diaspora Discussion Google Group](http://groups.google.com/group/diaspora-discuss)
|
|
- [Diaspora Q&A site](http://diaspora.shapado.com/)
|
|
- [Diaspora on Get Satisfaction](http://getsatisfaction.com/diaspora/)
|
|
- [#diaspora IRC channel](irc://irc.freenode.net/#diaspora)
|
|
([join via the web client](http://webchat.freenode.net?channels=diaspora))
|
|
- [#diaspora-dev IRC channel](irc://irc.freenode.net/#diaspora-dev)
|
|
([join via the web client](http://webchat.freenode.net?channels=diaspora-dev))
|
|
|
|
More general info and updates about the project can be found on
|
|
[our blog](http://blog.joindiaspora.com),
|
|
[and on Twitter](http://twitter.com/joindiaspora).
|
|
Also, be sure to join the official [mailing list](http://eepurl.com/Vebk).
|
|
|
|
If you wish to contact us privately about any exploits in Diaspora you may
|
|
find, you can email
|
|
[exploits@joindiaspora.com](mailto:exploits@joindiaspora.com), [corresponding public key (keyID: 77485064)](http://pgp.mit.edu:11371/pks/lookup?op=vindex&search=0xCC6CAED977485064).
|