Improve documentation

[cmahnke]

I'm currently try to inline SVG files from SCSS files, but can't get it to work, my expectation was that this just works (like in Vite), but it doesn't but even with trying to set up using postcss-url or similar...
But whats's the most annoying issue ist that there aren't even any error messages, I'm not sure which code is responsible, but I consider silent failing (itself) being a bug...