Remember that information in modules/fb/README.txt is (usually) more up-to-date than what you find here on drupal.org. Please read the README.txt first.
- Which version of Drupal for Facebook should I use?
Version 1.x was built on ancient (internet time) Facebook client APIs. It is obsolete.
Version 2.x is built on client APIs which facebook deprecated in mid 2010. Although at this time apps on this API still work, facebook has removed all documentation from the web and made it difficult to even find the client libraries for download. So this version may still work, but for new development you're better off with 3.x. Use 2.x only if you're already using it, or for some crazy reason need FBML canvas pages instead of iframe. (Version 2.x supports FBML canvas, version 3.x iframe only).
Version 3.x uses the latest facebook SDKs. Although historically facebook changes the SDKs way too often, there's reason to believe these will not change again soon. To their credit, these SDKs and the platform documentation are way better this time. That makes this branch of modules/fb smaller and simpler, too. For new development you should be using the 3.x branch. A 3.x beta was released in Sept 2010.
Checking out of git? Here's a guide to the branches...
- HEAD (Version 3.x for Drupal 6.x, currently under development)
- DRUPAL-6--2 (Version 2.x for Drupal 6.x, dev release. This code is fairly stable, as development efforts are now on the 3.x branch.)
- DRUPAL-6--2-0-RC2 (Version 2.x for Drupal 6.x, release candidate. Although the 2.x branch is close to stable 2.0 release, it probably will not ever reach 2.0. There will be a 3.0 first.)