Skip to content
Extraits de code Groupes Projets
README.md 4,78 ko
Newer Older
ilya's avatar
ilya a validé
# Diaspora
ilya's avatar
ilya a validé
The privacy aware, personally controlled, do-it-all, open source social
network. [Diaspora Project](http://diasporaproject.org)
ilya's avatar
ilya a validé

************************
Diaspora is currently going through a huge refactoring push, the code is changing fast!
If you want to do something big, reach out on IRC or the mailing list first, so you can contribute effectively <3333
************************

[![Build Status](https://secure.travis-ci.org/diaspora/diaspora.png)](http://travis-ci.org/diaspora/diaspora)
[![Dependency Status](https://gemnasium.com/diaspora/diaspora.png?travis)](https://gemnasium.com/diaspora/diaspora)
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.

Raphael Sofaer's avatar
Raphael Sofaer a validé
**THIS IS ALPHA SOFTWARE AND SHOULD BE TREATED ACCORDINGLY.**
**IT IS FUN TO GET RUNNING, BUT EXPECT THINGS TO BE BROKEN.**
ilya's avatar
ilya a validé

Daniel Grippi's avatar
Daniel Grippi a validé
## 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 
Daniel Grippi's avatar
Daniel Grippi a validé

Even if you're not a programmer, we'd love for you to give Diaspora a spin; all suggestions and comments welcome!


ilya's avatar
ilya a validé
## Installation instructions

Raphael's avatar
Raphael a validé
Installation instructions are [here](http://github.com/diaspora/diaspora/wiki/Installing-and-Running-Diaspora).
ilya's avatar
ilya a validé

ilya's avatar
ilya a validé
Thanks for helping battle test Diaspora.
Please report any bugs you see at [GitHub Issues](https://github.com/diaspora/diaspora/issues).
ilya's avatar
ilya a validé

Raphael's avatar
Raphael a validé
## Contributing to Diaspora
###[An introduction to the source code](http://github.com/diaspora/diaspora/wiki/An-Introduction-to-the-Diaspora-Source)
###[Issue tracker (bugs)](https://github.com/diaspora/diaspora/issues) - Currently going through major cleanup
###[How to use git](http://github.com/diaspora/diaspora/wiki/Git-Workflow)
zhitomirskiyi's avatar
zhitomirskiyi a validé

Here are a few good places to start:
Raphael's avatar
Raphael a validé

Raphael's avatar
Raphael a validé
- Run "rake spec" to run our [Rspec](http://blog.davidchelimsky.net/2007/05/14/an-introduction-to-rspec-part-i/) 
unit test suite.
Raphael's avatar
Raphael a validé

Raphael's avatar
Raphael a validé
- Run "rake cucumber" to run our [Cucumber](http://rubylearning.com/blog/2010/10/05/outside-in-development/)
Raphael Sofaer's avatar
Raphael Sofaer a validé
integration test suite.
Raphael's avatar
Raphael a validé

- Take a look at the [issue tracker](https://github.com/diaspora/diaspora/issues) and pick a bug.
Raphael's avatar
Raphael a validé
Write a spec for it, so it's easy for another developer to fix it.
Raphael's avatar
Raphael a validé

Raphael Sofaer's avatar
Raphael Sofaer a validé
Catches must be tested, and all your tests should be green, 
Raphael's avatar
Raphael a validé
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.
Raphael's avatar
Raphael a validé

Raphael's avatar
Raphael a validé
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.
Raphael's avatar
Raphael a validé

Raphael's avatar
Raphael a validé
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
Raphael Sofaer's avatar
Raphael Sofaer a validé
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)
MrZYX's avatar
MrZYX a validé
  ([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),
Pistos's avatar
Pistos a validé
[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).