filesystem.md - Document programmatic lookup

I've seen a incidents where an extension developer tries to hardcode paths
(based on their knowledge/understanding of the file-structure).  This is
usually a bad idea, so I'd like to expose the programmatic way as part of
the docs.