{"id":207,"date":"2025-11-27T12:57:34","date_gmt":"2025-11-27T17:57:34","guid":{"rendered":"https:\/\/pressbooks.bccampus.ca\/rdmoer\/?post_type=chapter&#038;p=207"},"modified":"2026-03-01T21:55:50","modified_gmt":"2026-03-02T02:55:50","slug":"readme-files","status":"publish","type":"chapter","link":"https:\/\/pressbooks.bccampus.ca\/rdmoer\/chapter\/readme-files\/","title":{"raw":"Readme Files","rendered":"Readme Files"},"content":{"raw":"<h4><a href=\"https:\/\/pressbooks.bccampus.ca\/rdmoer\/chapter\/common-types-of-documentation\/\">Previous Lesson<\/a><\/h4>\r\n<h4>Lesson 10 of 17<\/h4>\r\n<h3>A\u00a0<span style=\"color: #00ccff\"><strong>readme<\/strong><\/span>\u00a0file is a plain text file that is included in a folder or directory to provide additional information about the contents.<\/h3>\r\nWhen creating readme files to document your data, remember that the purpose of the readme file is to communicate any information that may be needed to properly interpret the data. Readmes may be used as documentation during data collection and in active phases of a project in addition to accompanying data for long-term storage, preservation, and deposit.\r\n\r\nConsider including readme files in your top-level folders that explain your organization, naming, and storage practices.\r\n\r\n&nbsp;\r\n<h2>Kristin Briney<sup>1<\/sup>\u00a0provides an example for an imagined chemistry project:<\/h2>\r\n<img class=\"wp-image-618 aligncenter\" src=\"https:\/\/pressbooks.bccampus.ca\/rdmoer\/wp-content\/uploads\/sites\/2528\/2025\/11\/Screenshot-2026-02-04-at-1.26.20-AM-300x207.png\" alt=\"\" width=\"796\" height=\"549\" \/>\r\n\r\nThe above example provides enough information for someone to know what the project is and to navigate through the folders. If your organization is complex, you may include other readme files as necessary to further describe your data.\r\n\r\n<sub>1. Briney, Kristin. (2014, February 25). Readme.txt. <em>DATA AB INITIO<\/em>: Managing data right, from the start.\u00a0<a href=\"http:\/\/dataabinitio.com\/?p=378\" target=\"_blank\" rel=\"noopener\">http:\/\/dataabinitio.com\/?p=378(opens in a new tab)<\/a>. The original is licensed under a\u00a0<a href=\"http:\/\/creativecommons.org\/licenses\/by\/4.0\/\" target=\"_blank\" rel=\"noopener\">Creative Commons Attribution 4.0 International license<\/a>.<\/sub>\r\n\r\n&nbsp;\r\n<div class=\"noOutline\" data-ba-index=\"6\" data-ba=\"lessonEdit.block\" data-block-id=\"cl5uiwo3f002h356qq13ken7n\">\r\n<div>\r\n<div class=\"block-statement block-statement--b bg--legacy-background block-wrapper bg bg--range-near-black bg--type-color\" data-ba=\"blocks.blockStatement\">\r\n<div class=\"block-statement__wrap\">\r\n<div class=\"block-statement__container\">\r\n<div class=\"block-statement__row\">\r\n<div>\r\n<div class=\"animated fadeInUp\">\r\n<div class=\"block-statement__col\">\r\n<div class=\"block-statement__quote brand--linkColor\">\r\n<div class=\"fr-view\">\r\n<h3>A readme file for data deposit may need to follow recommendations from the repository you want to deposit with, and typically includes the following information:<\/h3>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<div class=\"noOutline\" data-ba-index=\"7\" data-ba=\"lessonEdit.block\" data-block-id=\"cl5uixb8d002m356q8ekp3hxw\">\r\n<div class=\"block-list block-list--bulleted bg--legacy-background block-wrapper bg bg--range-near-black bg--type-color\" data-ba=\"blocks.blockList\">\r\n<div class=\"block-list__container\">\r\n<div class=\"block-list__row\">\r\n<div class=\"block-list__col\">\r\n<ul class=\"block-list__list\" role=\"list\">\r\n \t<li class=\"block-list__item block-list__animated-item animated fadeInRight\" role=\"listitem\">\r\n<div class=\"block-list__content__left\">\r\n<div class=\"hidden block-list__content brand--body brand--linkColor brand--linkColor\" aria-hidden=\"true\">\r\n<div class=\"fr-view\">\r\n\r\n<span style=\"font-size: 1em;text-align: initial\">General information about the research project for which it was collected (the principal investigator, grant, dates, and locations of data collection)<\/span>\r\n\r\n<\/div>\r\n<\/div>\r\n<\/div><\/li>\r\n \t<li class=\"block-list__item block-list__animated-item animated fadeInRight\" role=\"listitem\">\r\n<div class=\"block-list__content__left\">\r\n<div class=\"hidden block-list__content brand--body brand--linkColor brand--linkColor\" aria-hidden=\"true\">\r\n<div class=\"fr-view\">\r\n\r\n<span style=\"font-size: 1em;text-align: initial\">An overview of the files and their formats<\/span>\r\n\r\n<\/div>\r\n<\/div>\r\n<\/div><\/li>\r\n \t<li class=\"block-list__item block-list__animated-item animated fadeInRight\" role=\"listitem\">\r\n<div class=\"block-list__content__left\">\r\n<div class=\"hidden block-list__content brand--body brand--linkColor brand--linkColor\" aria-hidden=\"true\">\r\n<div class=\"fr-view\">\r\n\r\n<span style=\"font-size: 1em;text-align: initial\">Any sharing restrictions of licenses to be applied to the data<\/span>\r\n\r\n<\/div>\r\n<\/div>\r\n<\/div><\/li>\r\n \t<li class=\"block-list__item block-list__animated-item animated fadeInRight\" role=\"listitem\">\r\n<div class=\"block-list__content__left\">\r\n<div class=\"hidden block-list__content brand--body brand--linkColor brand--linkColor\" aria-hidden=\"true\">\r\n<div class=\"fr-view\">\r\n\r\n<span style=\"font-size: 1em;text-align: initial\">Methodology (how data was collected and processed, including any standards or measures)<\/span>\r\n\r\n<\/div>\r\n<\/div>\r\n<\/div><\/li>\r\n \t<li class=\"block-list__item block-list__animated-item animated fadeInRight\" role=\"listitem\">\r\n<div class=\"block-list__content__left\">\r\n<div class=\"hidden block-list__content brand--body brand--linkColor brand--linkColor\" aria-hidden=\"true\">\r\n<div class=\"fr-view\">\r\n\r\n<span style=\"font-size: 1em;text-align: initial\">Any other information specific to the data (e.g., a count and list of variables)<\/span>\r\n\r\n&nbsp;\r\n\r\n<\/div>\r\n<\/div>\r\n<\/div><\/li>\r\n<\/ul>\r\n<div class=\"textbox shaded\">\r\n<p style=\"text-align: center\">Note that the above list was abbreviated from Cornell's\u00a0<em>Guide to writing \"readme\" style metadata<\/em>. Please refer to their guide for more in-depth explanations.<\/p>\r\n<p style=\"text-align: center\"><a href=\"https:\/\/data.research.cornell.edu\/data-management\/sharing\/readme\/\">READ THE GUIDE<\/a><\/p>\r\n\r\n<\/div>\r\n<div class=\"textbox shaded\">\r\n<p style=\"text-align: center\">This template was created by Cornell University and is available to be re-used and repurposed under a\u00a0<a href=\"https:\/\/creativecommons.org\/publicdomain\/zero\/1.0\/\" target=\"_blank\" rel=\"noopener noreferrer\">CC0 1.0<\/a>\u00a0public domain license.<\/p>\r\n<p style=\"text-align: center\"><a href=\"https:\/\/cornell.app.box.com\/v\/ReadmeTemplate\">GO TO TEMPLATE<\/a><\/p>\r\n\r\n<\/div>\r\n<h4><a href=\"https:\/\/pressbooks.bccampus.ca\/rdmoer\/chapter\/activity-3-2-reflection\/\">Next Lesson<\/a><\/h4>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>\r\n<\/div>","rendered":"<h4><a href=\"https:\/\/pressbooks.bccampus.ca\/rdmoer\/chapter\/common-types-of-documentation\/\">Previous Lesson<\/a><\/h4>\n<h4>Lesson 10 of 17<\/h4>\n<h3>A\u00a0<span style=\"color: #00ccff\"><strong>readme<\/strong><\/span>\u00a0file is a plain text file that is included in a folder or directory to provide additional information about the contents.<\/h3>\n<p>When creating readme files to document your data, remember that the purpose of the readme file is to communicate any information that may be needed to properly interpret the data. Readmes may be used as documentation during data collection and in active phases of a project in addition to accompanying data for long-term storage, preservation, and deposit.<\/p>\n<p>Consider including readme files in your top-level folders that explain your organization, naming, and storage practices.<\/p>\n<p>&nbsp;<\/p>\n<h2>Kristin Briney<sup>1<\/sup>\u00a0provides an example for an imagined chemistry project:<\/h2>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-618 aligncenter\" src=\"https:\/\/pressbooks.bccampus.ca\/rdmoer\/wp-content\/uploads\/sites\/2528\/2025\/11\/Screenshot-2026-02-04-at-1.26.20-AM-300x207.png\" alt=\"\" width=\"796\" height=\"549\" srcset=\"https:\/\/pressbooks.bccampus.ca\/rdmoer\/wp-content\/uploads\/sites\/2528\/2025\/11\/Screenshot-2026-02-04-at-1.26.20-AM-300x207.png 300w, https:\/\/pressbooks.bccampus.ca\/rdmoer\/wp-content\/uploads\/sites\/2528\/2025\/11\/Screenshot-2026-02-04-at-1.26.20-AM-1024x707.png 1024w, https:\/\/pressbooks.bccampus.ca\/rdmoer\/wp-content\/uploads\/sites\/2528\/2025\/11\/Screenshot-2026-02-04-at-1.26.20-AM-768x530.png 768w, https:\/\/pressbooks.bccampus.ca\/rdmoer\/wp-content\/uploads\/sites\/2528\/2025\/11\/Screenshot-2026-02-04-at-1.26.20-AM-65x45.png 65w, https:\/\/pressbooks.bccampus.ca\/rdmoer\/wp-content\/uploads\/sites\/2528\/2025\/11\/Screenshot-2026-02-04-at-1.26.20-AM-225x155.png 225w, https:\/\/pressbooks.bccampus.ca\/rdmoer\/wp-content\/uploads\/sites\/2528\/2025\/11\/Screenshot-2026-02-04-at-1.26.20-AM-350x242.png 350w, https:\/\/pressbooks.bccampus.ca\/rdmoer\/wp-content\/uploads\/sites\/2528\/2025\/11\/Screenshot-2026-02-04-at-1.26.20-AM.png 1510w\" sizes=\"auto, (max-width: 796px) 100vw, 796px\" \/><\/p>\n<p>The above example provides enough information for someone to know what the project is and to navigate through the folders. If your organization is complex, you may include other readme files as necessary to further describe your data.<\/p>\n<p><sub>1. Briney, Kristin. (2014, February 25). Readme.txt. <em>DATA AB INITIO<\/em>: Managing data right, from the start.\u00a0<a href=\"http:\/\/dataabinitio.com\/?p=378\" target=\"_blank\" rel=\"noopener\">http:\/\/dataabinitio.com\/?p=378(opens in a new tab)<\/a>. The original is licensed under a\u00a0<a href=\"http:\/\/creativecommons.org\/licenses\/by\/4.0\/\" target=\"_blank\" rel=\"noopener\">Creative Commons Attribution 4.0 International license<\/a>.<\/sub><\/p>\n<p>&nbsp;<\/p>\n<div class=\"noOutline\" data-ba-index=\"6\" data-ba=\"lessonEdit.block\" data-block-id=\"cl5uiwo3f002h356qq13ken7n\">\n<div>\n<div class=\"block-statement block-statement--b bg--legacy-background block-wrapper bg bg--range-near-black bg--type-color\" data-ba=\"blocks.blockStatement\">\n<div class=\"block-statement__wrap\">\n<div class=\"block-statement__container\">\n<div class=\"block-statement__row\">\n<div>\n<div class=\"animated fadeInUp\">\n<div class=\"block-statement__col\">\n<div class=\"block-statement__quote brand--linkColor\">\n<div class=\"fr-view\">\n<h3>A readme file for data deposit may need to follow recommendations from the repository you want to deposit with, and typically includes the following information:<\/h3>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<div class=\"noOutline\" data-ba-index=\"7\" data-ba=\"lessonEdit.block\" data-block-id=\"cl5uixb8d002m356q8ekp3hxw\">\n<div class=\"block-list block-list--bulleted bg--legacy-background block-wrapper bg bg--range-near-black bg--type-color\" data-ba=\"blocks.blockList\">\n<div class=\"block-list__container\">\n<div class=\"block-list__row\">\n<div class=\"block-list__col\">\n<ul class=\"block-list__list\" role=\"list\">\n<li class=\"block-list__item block-list__animated-item animated fadeInRight\" role=\"listitem\">\n<div class=\"block-list__content__left\">\n<div class=\"hidden block-list__content brand--body brand--linkColor brand--linkColor\" aria-hidden=\"true\">\n<div class=\"fr-view\">\n<p><span style=\"font-size: 1em;text-align: initial\">General information about the research project for which it was collected (the principal investigator, grant, dates, and locations of data collection)<\/span><\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/li>\n<li class=\"block-list__item block-list__animated-item animated fadeInRight\" role=\"listitem\">\n<div class=\"block-list__content__left\">\n<div class=\"hidden block-list__content brand--body brand--linkColor brand--linkColor\" aria-hidden=\"true\">\n<div class=\"fr-view\">\n<p><span style=\"font-size: 1em;text-align: initial\">An overview of the files and their formats<\/span><\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/li>\n<li class=\"block-list__item block-list__animated-item animated fadeInRight\" role=\"listitem\">\n<div class=\"block-list__content__left\">\n<div class=\"hidden block-list__content brand--body brand--linkColor brand--linkColor\" aria-hidden=\"true\">\n<div class=\"fr-view\">\n<p><span style=\"font-size: 1em;text-align: initial\">Any sharing restrictions of licenses to be applied to the data<\/span><\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/li>\n<li class=\"block-list__item block-list__animated-item animated fadeInRight\" role=\"listitem\">\n<div class=\"block-list__content__left\">\n<div class=\"hidden block-list__content brand--body brand--linkColor brand--linkColor\" aria-hidden=\"true\">\n<div class=\"fr-view\">\n<p><span style=\"font-size: 1em;text-align: initial\">Methodology (how data was collected and processed, including any standards or measures)<\/span><\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/li>\n<li class=\"block-list__item block-list__animated-item animated fadeInRight\" role=\"listitem\">\n<div class=\"block-list__content__left\">\n<div class=\"hidden block-list__content brand--body brand--linkColor brand--linkColor\" aria-hidden=\"true\">\n<div class=\"fr-view\">\n<p><span style=\"font-size: 1em;text-align: initial\">Any other information specific to the data (e.g., a count and list of variables)<\/span><\/p>\n<p>&nbsp;<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/li>\n<\/ul>\n<div class=\"textbox shaded\">\n<p style=\"text-align: center\">Note that the above list was abbreviated from Cornell&#8217;s\u00a0<em>Guide to writing &#8220;readme&#8221; style metadata<\/em>. Please refer to their guide for more in-depth explanations.<\/p>\n<p style=\"text-align: center\"><a href=\"https:\/\/data.research.cornell.edu\/data-management\/sharing\/readme\/\">READ THE GUIDE<\/a><\/p>\n<\/div>\n<div class=\"textbox shaded\">\n<p style=\"text-align: center\">This template was created by Cornell University and is available to be re-used and repurposed under a\u00a0<a href=\"https:\/\/creativecommons.org\/publicdomain\/zero\/1.0\/\" target=\"_blank\" rel=\"noopener noreferrer\">CC0 1.0<\/a>\u00a0public domain license.<\/p>\n<p style=\"text-align: center\"><a href=\"https:\/\/cornell.app.box.com\/v\/ReadmeTemplate\">GO TO TEMPLATE<\/a><\/p>\n<\/div>\n<h4><a href=\"https:\/\/pressbooks.bccampus.ca\/rdmoer\/chapter\/activity-3-2-reflection\/\">Next Lesson<\/a><\/h4>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n","protected":false},"author":2543,"menu_order":10,"template":"","meta":{"pb_show_title":"on","pb_short_title":"","pb_subtitle":"","pb_authors":[],"pb_section_license":""},"chapter-type":[],"contributor":[],"license":[],"class_list":["post-207","chapter","type-chapter","status-publish","hentry"],"part":184,"_links":{"self":[{"href":"https:\/\/pressbooks.bccampus.ca\/rdmoer\/wp-json\/pressbooks\/v2\/chapters\/207","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pressbooks.bccampus.ca\/rdmoer\/wp-json\/pressbooks\/v2\/chapters"}],"about":[{"href":"https:\/\/pressbooks.bccampus.ca\/rdmoer\/wp-json\/wp\/v2\/types\/chapter"}],"author":[{"embeddable":true,"href":"https:\/\/pressbooks.bccampus.ca\/rdmoer\/wp-json\/wp\/v2\/users\/2543"}],"version-history":[{"count":9,"href":"https:\/\/pressbooks.bccampus.ca\/rdmoer\/wp-json\/pressbooks\/v2\/chapters\/207\/revisions"}],"predecessor-version":[{"id":751,"href":"https:\/\/pressbooks.bccampus.ca\/rdmoer\/wp-json\/pressbooks\/v2\/chapters\/207\/revisions\/751"}],"part":[{"href":"https:\/\/pressbooks.bccampus.ca\/rdmoer\/wp-json\/pressbooks\/v2\/parts\/184"}],"metadata":[{"href":"https:\/\/pressbooks.bccampus.ca\/rdmoer\/wp-json\/pressbooks\/v2\/chapters\/207\/metadata\/"}],"wp:attachment":[{"href":"https:\/\/pressbooks.bccampus.ca\/rdmoer\/wp-json\/wp\/v2\/media?parent=207"}],"wp:term":[{"taxonomy":"chapter-type","embeddable":true,"href":"https:\/\/pressbooks.bccampus.ca\/rdmoer\/wp-json\/pressbooks\/v2\/chapter-type?post=207"},{"taxonomy":"contributor","embeddable":true,"href":"https:\/\/pressbooks.bccampus.ca\/rdmoer\/wp-json\/wp\/v2\/contributor?post=207"},{"taxonomy":"license","embeddable":true,"href":"https:\/\/pressbooks.bccampus.ca\/rdmoer\/wp-json\/wp\/v2\/license?post=207"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}