File naming and ownership

Woof! expects applications to follow certain conventions in naming files and placing them within the Woof! directory tree. These conventions are used in locating files such as resource files and to avoid name clashes, for example during upgrades.

Directory ownership

Among the directories described in Directory structure, Woof! is assumed to own all directories except the public app temp and config subdirectories. In this context, own means that applications should not place their files in any other directories except those listed above as they might be overwritten on upgrades.

File ownership

Even within the application-owned directories, Woof! expects to own files whose names begin with the _ (underscore) character and all files and nested subdirectories inside subdirectories that begin with that character. These may be overwritten on an upgrade.

Applications should follow these conventions to avoid file naming conflicts with files shipped as part of Woof!