I did a bit of searching and found this thread on the topic but it’s specific to XML files, and so the answer makes sense (/etc/) for XML files.
In my case, I’m actually storing a txt file, which happens to be an SVN version number that I dumped out within my modman script.
The place that I’m using this is within a frontend model (Blocks/System/Html.php) which outputs the version number within the module config. So I went with the Blocks/System/ directory for now – the filename is Version.txt – but it feels like there should be a better place to put this.
I ran into the same kind of problem when developing a shipping module. I had a bunch of CSV files that contained maximum weight / delivery cost mappings. For what it’s worth, I created a
data/directory at the module level and threw everything in there.I don’t think this kind of situation doesn’t happens often enough in the Magento codebase for there to be an established convention. As long as you use sensible naming, and provide a level of abstraction to cope with any change of file location in the future, I’d say put it in any folder at your module’s root.