Documentation can be found at Bethe-Salpeter Equation - Theory.
The BSE module can work very well for small bulk systems. See gpaw/test/bse_silicon.py as an example. Recently I have implemented using scalapack library to diagonalize the BSE matrix, so in principle, it can also work for relatively bigger systems. Bigger tests coming soon.