Some pieces in the entry were borrowed from Red's GitHub wiki, so it may need some updating. I'd also love to cover some of the more recent development with directories, including designating a pod/hub as a directory server and the concept of realms.
Proposal:User Directories in Diaspora - diaspora* project wiki
This proposal is a work-in-progress. The purpose is to revisit some of the core ideas in how user discovery is currently done within Diaspora as well as the wider free web. At the moment, Diaspora has three pieces of the puzzle regarding user discovery. These three methods have historically played a part in how Diaspora users end up connecting on the network.