update some samples / tests for the SourceFile api change
minor docs / comments improvement since bus removal