History of Anatomy of a Package

The following files make up a bitweaver package. Your packages is free to do and act however it pleases. However, the following files are standardized and the core packages will look for these files in your packages. Only one is truly required.

Anatomy of a bitweaver Package

File	Description	Col 3
bit_setup_inc.php	This is the only file required for a package. It registers information about the package during initial setup.
admin/schema_inc.php	If your package has any database information, the information is defined in this file. It will be scanned during install, and a few adminstration pages
modules/	This directory contains the interfaces blocks that can be arranged in various layouts

The following files make up a bitweaver package. Your packages is free to do and act however it pleases. However, the following files are standardized and the core packages may look for these files in your packages.

Anatomy of a bitweaver Package

File	Description
pkg/bit_setup_inc.php	This is the only file required for a package. It registers information about the package during initial setup.
pkg/admin/schema_inc.php pkg/admin/bit_schema_inc.php	If your package has any database information, the information is defined in this file. It will be scanned during install, and a few administration pages
pkg/admin/admin_pkg_inc.php pkg/admin/bit_admin_inc.php	Administration page for the package, picked up by kernel/admin/index.php?page=pkg.
pkg/admin/upgrades/	This directory contains files named with the form version.php that describe package versions and any code needed to upgrade data and tables when that version upgrade occurs.
pkg/modules/	This directory contains the interfaces blocks that can be arranged in various layouts
pkg/templates/	This directory contains the Smarty templates for the package pages
pkg/templates/admin_pkg.tpl pkg/templates/bit_admin.tpl	Administration template for the package, picked up by kernel/admin/index.php?page=pkg.
pkg/templates/menu_pkg_admin.tpl pkg/templates/bit_admin_menu.tpl	template for the package administration menu.
pkg/templates/menu_pkg.tpl pkg/templates/menu.tpl	template for the package menu. Usually specified in pkg/bit_setup_inc.php.

The filenames specified in grey are my thoughts are what the file names could be migrated to with the aim of improving consistency and ease of understanding. The ideas being; that there is no point in package name repetition/redundancy in the file names and it is already discouraged in the CodingGuidelines, and that introducing a prefix of 'bit_' to files that are loaded just because of their names and location in a package would help indicate them as such files.