Difference between revisions of "File Naming Conventions"

From Kumu Wiki - TRU
Jump to navigation Jump to search
 
(18 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
== File Naming Conventions Another Version 2014 ==
 
== File Naming Conventions ==
 
== File Naming Conventions ==
 +
File naming conventions are used in Curriculum Services for draft and final files, as explained here.
 +
# Draft files are those that are in development or production in Curriculum Services.
 +
 +
:::All draft course files (Word and PDF) are named according to the following example:
 +
 +
::::'''ABCD1231_TYPE_ITEM#_DATE_IN_DRAFT.pdf or .doc (all upper case)'''
 +
 +
::Where:
 +
 +
::'''ABCD1231''' is the course code (acronym and number; for example: ADMN4871)
 +
 +
 +
::'''TYPE''' is the type of document, as follows:
 +
 +
:{|
 +
|-
 +
| AK = Answer Key      || KN = Lab Kit Notes
 +
|-
 +
| AS = Assignments|| MP = Major Project
 +
|-
 +
| CM = Course Manual|| PE = Practice Exam
 +
|-
 +
| CU = Course Units|| RD = Readings
 +
|-
 +
| FE = Final Exam|| SG = Study Guide
 +
|-
 +
| FEG = Final Exam Guide|| OLFMG = OLFM Guide
 +
|}
 +
 +
::In the case of multiple files of the same type, a unique identifier can be added to the type—for example, AS_C for Assignments C or CU_A for Unit A.
 +
 +
::'''DATE''' is the last date that the file was changed for a draft or the date of sign‐off for the final document—for example, DDMMMYYYY or 12OCT2007 for October 12, 2007.
 +
 +
::'''IN''' is the initials of the person who generated that file.
 +
 +
::'''Here is a full example:'''
 +
 +
::ADMN4871_SG_205611_02NOV2007_NK_DRAFT.pdf  is the draft Study Guide with the item number 205611 for course ADMN4871, which was last changed on November 2nd 2007 and generated by Nick Kirby.
 +
 +
 +
:2. Final files (after sign off by Project Administrator)
 +
 +
::Once the work has been completed, the files will be renamed according to the following example:
 +
 +
:::'''ABCD1231_TYPE_ITEM#_DATE_FINAL.pdf or .doc (all upper case)'''
 +
 +
::Where:
 +
 +
::'''DATE''' is changed to reflect only the month and year of the final document (e.g., MMMYYYY or OCT2008 for October 2008).
 +
 +
::'''Here is a full example:'''
 +
 +
:::ADMN4871_SG_205611_NOV2008_FINAL.pdf is the final Study Guide with the item number 205611 for course ADMN487, which was last changed in November 2008.
 +
 +
== File Naming Conventions -- OLD ==
 
We use file naming conventions in Curriculum Services for syntactical consistency, which in turn supports file management and helps Production to identify how files should be organized.  
 
We use file naming conventions in Curriculum Services for syntactical consistency, which in turn supports file management and helps Production to identify how files should be organized.  
  
Line 12: Line 68:
 
Where:  
 
Where:  
  
# ABCD1231 is the course code—the  (acronym and number; for example: ADMN487, ENGL1061)  
+
ABCD1231 is the course code—the  (acronym and number; for example: ADMN487, ENGL1061)  
# TYPE is the type of document and could include a subdivision, such as the file’s number or letter, as follows:  
+
 
 +
TYPE is the type of document and could include a subdivision, such as the file’s number or letter, as follows:  
 
:CG = Course Guide
 
:CG = Course Guide
 
:CU = Course Units  
 
:CU = Course Units  
Line 32: Line 89:
 
:FE = Final Exam
 
:FE = Final Exam
 
:FEG = Final Exam Guide
 
:FEG = Final Exam Guide
 +
  
 
In the case of multiple files of the same type, a unique identifier can be added to the type—for example, AS_C for Assignments C or CU_A for Unit A.  
 
In the case of multiple files of the same type, a unique identifier can be added to the type—for example, AS_C for Assignments C or CU_A for Unit A.  
# DATE DDMMYYYY is the date the last date that the file was last changed modifiedfor a draft or the date of sign‐off for the final document.
 
  
For example: , DDMMMYYYY or 121SEPOCT2007013 for October 12, 2007.  
+
DATE DDMMYYYY is the date the last date that the file was last changed modifiedfor a draft or the date of sign‐off for the final document.
 +
 
 +
For example: , DDMMMYYYY or 21OCT2014 for October 21, 2014.
 +
 
 +
IN is the initials of the person who generated that filewho last modified the file.
 +
 
 +
DRAFT means that the Course Lead has not yet reviewed and signed off on the file. This is sometimes not included if the file name is lengthy (as for readings or PowerPoint files ).
  
# IN is the initials of the person who generated that filewho last modified the file.
+
Do not add a filename extension (this happens automatically)  
# DRAFT means that the Course Lead has not yet reviewed and signed off on the file. This is sometimes not included if the file name is lengthy (as for readings or PowerPoint files ).
 
# Do not add a filename extension (this happens automatically)  
 
 
   
 
   
 
Here is a full example of a named draft file:
 
Here is a full example of a named draft file:
 +
 
:Indented line
 
:Indented line
ENGL1061_CU1_1SEP2013_DLM_DRAFT.doc [all uppercase except extension]
+
ENGL1061_CU1_1SEP2014_DLM_DRAFT.doc [all uppercase except extension]
  
 
=== Resource Files ===
 
=== Resource Files ===
Line 69: Line 131:
  
 
== File Naming Conventions 2007 ==
 
== File Naming Conventions 2007 ==
https://www.dropbox.com/s/bgcl2cy6sbcyirn/ORIGINAL_FIle%20_Naming_Conventions_2007.pdf
 
  
 
Naming conventions for course files  
 
Naming conventions for course files  
 
All course files (Word and PDF) touched by the Production team should be named  
 
All course files (Word and PDF) touched by the Production team should be named  
 
according to the following example:  
 
according to the following example:  
 +
:Indented line
 
ABCD123_TYPE_DATE_IN_STATUS.pdf or .doc  
 
ABCD123_TYPE_DATE_IN_STATUS.pdf or .doc  
 +
 
where  
 
where  
 +
:Indented line
 
ABCD123 is the course code (e.g. ADMN487)  
 
ABCD123 is the course code (e.g. ADMN487)  
 +
 
TYPE is the type of document:  
 
TYPE is the type of document:  
  SG = Study Guide  
+
   
CM = Course Manual  
+
:SG = Study Guide
RD = Readings  
+
: CM = Course Manual
AS = Assignments  
+
: RD = Readings
PE = Practice Exam  
+
: AS = Assignments
FE = Final Exam  
+
: PE = Practice Exam
FEG = Final Exam Guide  
+
: FE = Final Exam
LKN = Lab Kit Notes  
+
: FEG = Final Exam Guide
CU = Course Units or Modules  
+
: LKN = Lab Kit Notes
AK = Answer Key  
+
: CU = Course Units or Modules
 +
: AK = Answer Key  
 +
 
 
In case of multiple files of the same type a unique identifier can be added to  
 
In case of multiple files of the same type a unique identifier can be added to  
 
the type, e.g. AS_C for Assignment File C or CU_A for Unit A.  
 
the type, e.g. AS_C for Assignment File C or CU_A for Unit A.  
 +
 
DATE is the last date that the file was changed for a draft or the date of sign-off  
 
DATE is the last date that the file was changed for a draft or the date of sign-off  
 
for the final document (e.g. DDMMMYYYY or 12OCT2007 for October 12,  
 
for the final document (e.g. DDMMMYYYY or 12OCT2007 for October 12,  
 
2007).  
 
2007).  
 +
 
IN are the initials of the person who generated that file.  
 
IN are the initials of the person who generated that file.  
 +
 
STATUS is the current status of the file:  
 
STATUS is the current status of the file:  
DRAFT = File is a draft only and has not been signed off by the  
+
* DRAFT = File is a draft only and has not been signed off by the instructional designer.   
Instructional Designer.   
+
* FINAL = File has been signed off by the Instructional Designer and should not be changed in any way without the approval of the instructional designer, operations manager or production supervisor.  
October 23, 2007
+
FINAL = File has been signed off by the Instructional Designer and should  
 
not be changed in any way without the approval of the Instructional
 
Designer, Operations Manager or Production Supervisor.  
 
 
Examples:  
 
Examples:  
  ADMN487_SG_02NOV2007_NK_DRAFT.pdf is the draft Study Guide for  
+
   
course ADMN487 which was last changed on November 2nd
+
:Indented line
2007 and  
+
ADMN487_SG_02NOV2007_NK_DRAFT.pdf is the draft Study Guide for course ADMN487 which was last changed on November 2nd,
generated by Nick Kirby.  
+
2007 and generated by Nick Kirby.  
FRST305_CM_12OCT2007_MV_FINAL.pdf is the signed-off and final Course  
+
 
Manual for FRST305 which was signed off on October 12th
+
:Indented line
  2007 and  
+
FRST305_CM_12OCT2007_MV_FINAL.pdf is the signed-off and final Course Manual for FRST305 which was signed off on October 12th, 2007 and generated by Martin Voelkening.
generated by Martin Voelkening.
 

Latest revision as of 12:47, 25 February 2014

File Naming Conventions Another Version 2014

File Naming Conventions

File naming conventions are used in Curriculum Services for draft and final files, as explained here.

  1. Draft files are those that are in development or production in Curriculum Services.
All draft course files (Word and PDF) are named according to the following example:
ABCD1231_TYPE_ITEM#_DATE_IN_DRAFT.pdf or .doc (all upper case)
Where:
ABCD1231 is the course code (acronym and number; for example: ADMN4871)


TYPE is the type of document, as follows:
AK = Answer Key KN = Lab Kit Notes
AS = Assignments MP = Major Project
CM = Course Manual PE = Practice Exam
CU = Course Units RD = Readings
FE = Final Exam SG = Study Guide
FEG = Final Exam Guide OLFMG = OLFM Guide
In the case of multiple files of the same type, a unique identifier can be added to the type—for example, AS_C for Assignments C or CU_A for Unit A.
DATE is the last date that the file was changed for a draft or the date of sign‐off for the final document—for example, DDMMMYYYY or 12OCT2007 for October 12, 2007.
IN is the initials of the person who generated that file.
Here is a full example:
ADMN4871_SG_205611_02NOV2007_NK_DRAFT.pdf is the draft Study Guide with the item number 205611 for course ADMN4871, which was last changed on November 2nd 2007 and generated by Nick Kirby.


2. Final files (after sign off by Project Administrator)
Once the work has been completed, the files will be renamed according to the following example:
ABCD1231_TYPE_ITEM#_DATE_FINAL.pdf or .doc (all upper case)
Where:
DATE is changed to reflect only the month and year of the final document (e.g., MMMYYYY or OCT2008 for October 2008).
Here is a full example:
ADMN4871_SG_205611_NOV2008_FINAL.pdf is the final Study Guide with the item number 205611 for course ADMN487, which was last changed in November 2008.

File Naming Conventions -- OLD

We use file naming conventions in Curriculum Services for syntactical consistency, which in turn supports file management and helps Production to identify how files should be organized.

We use naming conventions for the draft and final files of main course components. For other course resources files—readings, Excel workbooks, PowerPoints, images—we include key elements: Course Acronym, Location, and a short relevant descriptor. draft and final files, as explained here.

Draft Files

Draft files are those that are in development or production Production in Curriculum Services. All draft course files (Word and PDF) are named according to the following examplethus:

ABCD1231_TYPE__ITEM#_DATEDDMMMYYYY_IN_DRAFT.pdf o r .doc (all upper case)

Where:

ABCD1231 is the course code—the (acronym and number; for example: ADMN487, ENGL1061)

TYPE is the type of document and could include a subdivision, such as the file’s number or letter, as follows:

CG = Course Guide
CU = Course Units
CM = Course Modules
MOD = Module (and number or letter; e.g., MOD1)
AS = Assignments
MP = Major Project
PE = Practice Exam
EX_A = Final Exam, Form*
AK_A = Final Exam Answer Key, Form
OLFMG = Open Learning Faculty Member Guide
AK = Answer Key
RD = Reading(s)
SS = Style Sheet
AS = Assignments
CM = Course Manual
CU = Course
FE = Final Exam
FEG = Final Exam Guide


In the case of multiple files of the same type, a unique identifier can be added to the type—for example, AS_C for Assignments C or CU_A for Unit A.

DATE DDMMYYYY is the date the last date that the file was last changed modifiedfor a draft or the date of sign‐off for the final document.

For example: , DDMMMYYYY or 21OCT2014 for October 21, 2014.

IN is the initials of the person who generated that filewho last modified the file.

DRAFT means that the Course Lead has not yet reviewed and signed off on the file. This is sometimes not included if the file name is lengthy (as for readings or PowerPoint files ).

Do not add a filename extension (this happens automatically)

Here is a full example of a named draft file:

Indented line

ENGL1061_CU1_1SEP2014_DLM_DRAFT.doc [all uppercase except extension]

Resource Files

Other course resources files might include readings, Excel workbooks, PowerPoints, images, and so on. For these files, we use key elements: Course Acronym, Location, and a short but relevant descriptor. Example: APEC1671_MOD1_Title_of_reading The descriptor must match the actual, verbatim title of the resource, though it can be a truncated version of said title.

Final Files

After course development and sign-off by the Course Lead, who sends the files to Production, Production renames the files:ADMN487_SG_205611_02NOV2007_NK_DRAFT.pdf is the draft Study Guide with the item number 205611 for course ADMN487, which was last changed on November 2nd 2007 and generated by Nick Kirby.

  1. 1. Final files (after sign off by Project Administrator)

Once the work has been completed, the files will be renamed according to the following example: ABCD1231_TYPE_MMMYYYY_ITEM#_XXXXXX DATE_FINAL.pdf or .doc (all upper case) Where:

  1. Numbered list item

1. DATE is changed to to reflect only the month and year of the final document (e.g., MMMYYYY or OCT2008 for October 2008month and year only). 2. XXXXXX: the Item Number is put in. 3. IN is dropped. 4. DRAFT is changed to FINAL.


Here is a full example:

  • • ADMN487_SG_205611_NOV2008_FINAL.pdf is the final Study Guide with the item number 205611 for course ADMN487, which was last changed in November 2008.

The final files are emailed by the Production Supervisor to the Divisional Secretary for upload to the GroupWise Library (with all previous tracked changes accepted, comments deleted, and track changes disabled).- Final versions of the file are held by Production within an organized storage format.

File Naming Conventions 2007

Naming conventions for course files All course files (Word and PDF) touched by the Production team should be named according to the following example:

Indented line

ABCD123_TYPE_DATE_IN_STATUS.pdf or .doc

where

Indented line

ABCD123 is the course code (e.g. ADMN487)

TYPE is the type of document:

SG = Study Guide
CM = Course Manual
RD = Readings
AS = Assignments
PE = Practice Exam
FE = Final Exam
FEG = Final Exam Guide
LKN = Lab Kit Notes
CU = Course Units or Modules
AK = Answer Key

In case of multiple files of the same type a unique identifier can be added to the type, e.g. AS_C for Assignment File C or CU_A for Unit A.

DATE is the last date that the file was changed for a draft or the date of sign-off for the final document (e.g. DDMMMYYYY or 12OCT2007 for October 12, 2007).

IN are the initials of the person who generated that file.

STATUS is the current status of the file:

  • DRAFT = File is a draft only and has not been signed off by the instructional designer.
  • FINAL = File has been signed off by the Instructional Designer and should not be changed in any way without the approval of the instructional designer, operations manager or production supervisor.

Examples:

Indented line

ADMN487_SG_02NOV2007_NK_DRAFT.pdf is the draft Study Guide for course ADMN487 which was last changed on November 2nd, 2007 and generated by Nick Kirby.

Indented line

FRST305_CM_12OCT2007_MV_FINAL.pdf is the signed-off and final Course Manual for FRST305 which was signed off on October 12th, 2007 and generated by Martin Voelkening.