FAQ for developers: Difference between revisions

From diaspora* project wiki
(Replaced content with "W")
m (Reverted edits by Tgtgyty (talk) to last revision by Airon90)
Line 1: Line 1:
W
We've started adding questions that we see a lot to this page, but it doesn't cover everything.
If you have other questions, the best way to get an answer quickly is to visit us in IRC.
You might think, "IRC? For real? Is this 1994 again?"
 
Yes. I mean, '''no!''' Just think of IRC as the open-source equivalent of a Campfire that developers sit around. ''Links to IRC channels and mailing lists are at the bottom of this page.''
 
== How do I get the latest source? ==
 
Pull the latest from github.
 
    git pull
 
Install any updates to gems:
 
    bundle install
 
== How do I reset the database to a totally clean state? ==
 
    rake db:drop db:create db:schema:load
 
== How do I get debug information? ==
 
You can use the command 
 
    tail -f log/development.log
 
to watch the log in development mode.
 
== I have found an issue with federation, how can I debug it? ==
 
We actually provide a special configuration for testing server-to-server communication, which produces logs that contain only the events around federation. It involves spinning up two Diaspora* instances which you can use to recreate realistic circumstances and the logs of both sides are recorded into a single file. 
See [[Federation_Logger | Federation Logger]]
 
== What if my question isn't answered here? ==
 
'''IRC Channels'''
 
IRC is the best way to get an answer quickly. Click the link to the join the channel in a new
browser window. You can also download and use an IRC client such as
[http://colloquy.info/ Colloquy] for OS X, [http://xchat.org/ XChat] for GNU/Linux or
[http://www.mirc.com/ mIRC] for Windows.
 
* [http://webchat.freenode.net/?channels=diaspora #diaspora on irc.freenode.net] - general discussion and help for folks installing Diaspora
* [http://webchat.freenode.net/?channels=diaspora-dev #diaspora-dev on irc.freenode.net] - discussion of the source code and help for new developer contributors
* [http://webchat.freenode.net/?channels=diaspora-de #diaspora-de on irc.freenode.net] - discussion in German.
 
'''Mailing lists'''
 
We have two mailing lists, both Google groups. They tend to have a slightly different audience than
the IRC channels, so if you can't get your question answered in IRC, you can try here.
 
* [http://groups.google.com/group/diaspora-discuss Discussion list] - Google group for discussion of non-technical topics
* [http://groups.google.com/group/diaspora-dev Development discussion list] - Google group for discussion of installation, source code, and other technical topics
 
== FAQ for web developers ==
 
If you're developing an external web site, and would like to know about adding diaspora related features to your site, you might want to look at the [[FAQ for web developers]].
 
{{Languages}}
 
[[Category:Developers]]
[[Category:Github transfer done]]

Revision as of 18:20, 25 September 2013

We've started adding questions that we see a lot to this page, but it doesn't cover everything. If you have other questions, the best way to get an answer quickly is to visit us in IRC. You might think, "IRC? For real? Is this 1994 again?"

Yes. I mean, no! Just think of IRC as the open-source equivalent of a Campfire that developers sit around. Links to IRC channels and mailing lists are at the bottom of this page.

How do I get the latest source?

Pull the latest from github.

   git pull

Install any updates to gems:

   bundle install

How do I reset the database to a totally clean state?

   rake db:drop db:create db:schema:load

How do I get debug information?

You can use the command

   tail -f log/development.log

to watch the log in development mode.

I have found an issue with federation, how can I debug it?

We actually provide a special configuration for testing server-to-server communication, which produces logs that contain only the events around federation. It involves spinning up two Diaspora* instances which you can use to recreate realistic circumstances and the logs of both sides are recorded into a single file. See Federation Logger

What if my question isn't answered here?

IRC Channels

IRC is the best way to get an answer quickly. Click the link to the join the channel in a new browser window. You can also download and use an IRC client such as Colloquy for OS X, XChat for GNU/Linux or mIRC for Windows.

Mailing lists

We have two mailing lists, both Google groups. They tend to have a slightly different audience than the IRC channels, so if you can't get your question answered in IRC, you can try here.

FAQ for web developers

If you're developing an external web site, and would like to know about adding diaspora related features to your site, you might want to look at the FAQ for web developers.

Template:Languages