University of Utah Library Guides
All University of Utah libraries course and research guides, in one place.

Files and Folders

README Files

There are many types of README files. What I'm talking about here is a README file to help you remember how you organized your folders and files on your computer, intranet, etc. TIP: Match your folder structure to your email folder structure so you do not have to think about two different folder naming schemes.

If you are a student taking classes for 4+ years that equals more than 30 classes, each with their own assignments and projects. You may want to refer back to the project or a report from a former class in your major. Having the organization of your folder and file naming conventions will help you locate the specific report.

If you are a researcher, then you are probably working on more than one project with multiple grants, teaching classes and serving on committees. Once the projects have been closed out or papers submitted for publication you will need to deposit the data, code and documentation into a data repository. The repository will also be asking for a README file. That README file will include a listing of all the files to be submitted to the repository along with pertinent information. Creating a README file for describing your file organization and naming conventions at the beginning of each project will save you time later.

Depending on how many files you have and for how many years you are going to maintain these files, you can create a README file for your directory or for each folder created within your directory.

A README file describing both the folders and files on your computer/intranet should contain:

  • A description of the contents of each folder.
  • A glossary of abbreviations used in the name of the folder/file and what they stand for - and definitions if needed.
  • A diagram describing the position of each element in the file/folder name.
  • A diagram or description of the folder/file structure on your directory.
  • A list of files within each folder.
  • The names of those who have access to each folder and their contact information.
  • The location of related files not stored on this system.
  • Any changes to the above and the date the change was made.

A README file describing the files within each folder on your computer/intranet should contain:

  • A description of the contents of the folder.
  • A glossary of abbreviations used in the file name and what they stand for - and definitions if needed.
  • A diagram describing the position of each element in the file name.
  • A diagram or description of the folder/file structure within each folder.
  • A list of files within each folder.
  • The names of those who have access to the folder and their contact information.
  • The location of related files not stored on this system.
  • Any changes to the above and the date the change was made.
Marriott Library Eccles Library Quinney Law Library