You are here: Home / OpenOffice.org / English / Userguide3 / Resources for contributors / Naming convention

Naming convention

Why have a naming convention?

To keep track of who is writing and reviewing documents, and when files were last changed, we have adopted a naming convention. This naming format includes all the necessary information in an unambiguous manner.

(Plone's system can be ambiguous for uploaded files such as ODT, because it records who did what on the *website* not the file itself. For example, it may records Andreas as creating a file on a particular date, but Andreas may have been uploading a file written or edited by someone else some time earlier. And once you download a file to your computer, you lose even the Plone information.)

The Format

This is the format decided upon:

  • First the base file name. For drafts, any meaningful basename is fine.
  • For revisions to published chapters, use the name of the published chapter as the basename (for example, 0201WG3-IntroducingWriter). Do not include spaces or punctuation (other than hyphens or underscores) in the file name.
  • Then the initials of the current maintainer.
  • Then the date the file was last edited, using the "20080712" format (year, month, day).
  • When a reviewer submits a revised version, the reviewer would also add their initials.
  • Each of these is separated by underscores.

Example

Suppose Daniel Carrera writes a chapter called "Introduction to Styles".

  1. Daniel initially names the file IntroStyles_DC_20090104.odt
  2. Jean Weber reviews the file and puts her edited version on the Feedback folder with the name IntroStyles_DC_JHW_20090110.odt (notice the change of date).
  3. Daniel revises the file and uploads the revised file as IntroStyles_DC_20090116.odt

Legal Disclaimers and Limitations | Privacy Policy | Impressum (Legal Info) | Copyright information: Unless otherwise specified, all text and images on this website are licensed under the Creative Commons Attribution-Share Alike 3.0. License. This does not include the source code of LibreOffice, which is licensed under the Mozilla Public License v2.0.

"LibreOffice" and "The Document Foundation" are registered trademarks in one or more countries. Their respective logos and icons are also subject to international copyright laws. Use thereof is explained in our trademark policy.