The file list records every file attached to a wiki page. Most of the files were small: a diagram that explained a flow, a sample model that showed a recipe input, or a configuration note that was easier to download than to copy from a page.
File types
- Model files. Small sample projects used to demonstrate a generation run.
- Diagrams. Layer diagrams, flow diagrams and class diagrams.
- Configuration notes. Short text files for a server or database setting.
- Schemas. Sample database scripts for the tutorial application.
Naming and versioning
Attach a file to the page it explains and give it a name that includes the release. A file named customer_model_63.zip is easier to place than one named sample.zip. When a file is replaced, keep the old version until the page no longer refers to it.
Keep files small. A sample model should contain the smallest design that demonstrates the point. Large samples are hard to read and rarely get opened.
The file list is also a useful check after a migration. If a page refers to a file that is not in the list, the page needs an edit.