Add a bit of docs.
Better (linear) algorithm for skipping failed sources.