[Home] . [What's New?] . [Active Ballots] . [Minutes] . [Maintenance] . [Interpretations] . [Public Docs] . [Committee Docs]
[802 Architecture Group] . [Data Center Bridging Task Group] [Time-Sensitive Networking Task Group]
[Email] . [Ancient Email] . [Meetings] . [802.1 MIBs] . [802.1 OIDs] . [IEEE 802] . [IEEE 802 PARs]
[802] . [802a] . [802b] . [802.1D] . [802.1D-2004] . [802.1G] . [802.1H-REV] . [802.1Q] . [802.1Q-REV] . [802.1s] . [802.1v] . [802.1w] . [802.1AB-2005] . [802.1AB-2009] . [802.1AC] . [802.1AC-Rev] . [802.1ad] . [802.1ag] . [802.1ah] . [802.1aj] . [802.1ak] . [802.1ap] . [802.1aq] . [802.1Qaw] . [802.1AX] . [802.1Qay] . [802.1Qbc] . [802.1Qbe] . [802.1Qbf] . [802.1AXbk] . [802.1Qbp] . [802.1AX-Rev] . [802.1Qbz] . [802.1Qca] . [802.1Qcc]
Security: [802.1X-2001] . [802.1X-2004] . [802.1X-2010] . [802.1AE] . [802.1af] . [802.1AR] . [802.1AEbn] . [802.1AEbw] . [802.1Xbx] . OmniRAN: [802.1CF]
TSN: [802.1AS] . [802.1ASbt] . [802.1Qat] . [802.1Qav] . [802.1BA] . [802.1Qbu] . [802.1Qbv] . [802.1CB] . [802.1Qcc] . DCB: [802.1Qau] . [802.1Qaz] . [802.1Qbb] . [802.1Qbg] . [802.1Qbh] . [802.3bd] . [802.1BR] . [802.1Qcd]

File naming conventions

When creating and uploading files intended for the access via the 802.1 website, please ensure that you follow the filename conventions below. The website is automated using scripts which rely on standardized filenaming conventions to create the web pages. Additionally, following the conventions makes it easier for people downloading a file to identify it. Filenames should contain exactly one dot (period), used to separate the filename from the 3-character extension indicating the content-type of the file (e.g., pdf for Adobe PDF documents). It is critical that filenames do not include spaces, hash signs, or other unusual characters. Please use only alphanumeric characters, hyphens and exactly one period.

Files in the Drafts directories

The private directories are at /web/infotree/groups/802/1/files/private. Each project has a directory here called xx-drafts, which should contain only other directories, one for each draft, called d0, d1, etc. All drafts 1.x for example reside in d1.

These directories contain draft standards (with and without changebars), comment dispositions (proposed or agreed), and MIBs. Some of these come in multiple versions. Each type of document has a corresponding filename format shown in the table below.

Filename templateDocument
802-1xx-dM-N.xtn802.1xx, draft M (or optionally M.N). "xtn" is a filename extension, such as ".pdf".
802-1xx-dM-N-cb.xtn802.1xx, draft M (or optionally M.N) with changebars.
802-1xx-dM-N-pdis-vVER.xtn802.1xx, draft M (or optionally M.N) proposed comment dispositions, optionally version-numbered VER.
802-1xx-dM-N-dis-vVER.xtn802.1xx, draft M (or optionally M.N) agreed comment dispositions (usually called just "comment dispositions"), optionally version-numbered VER.
802-1xx-dM-N-mib.txt802.1xx, draft M (or optionally M.N) MIB.
802-1xx-dM-N.mib802.1xx, draft M (or optionally M.N) MIB (alternate naming convention).

Files in the Public Documents directories

The public documents directories are at /web/infotree/groups/802/1/files/public. They are divided by calendar year of upload date, with docs2007 containing documents from 2007 for example. As with private documents, a "-cb" suffix can optionally be added before the filename extension to indicate the presence of change bars. Please note the date format is MMYY, that is, two digit month followed by two digit year! Do not include any spaces or unusual characters in the filename!

Filename templateDocument
xx-shortname-title-mmyy-vNN.xtnPresentation or document for project xx, authored by shortname with title title, dated MMYY, optionally version-numbered NN. "xtn" is a filename extension, such as ".pdf".
new-subj-shortname-title-mmyy-vNN.xtnPresentation or document for proposed project subj, authored by shortname with title title, dated MMYY, optionally version-numbered NN.
admin-shortname-title-mmyy-vNN.xtnNon-project administrative presentation or document, authored by shortname with title title, dated MMYY, optionally version-numbered NN.
liaison-shortname-title-mmyy-vNN.xtnliaison statement authored by shortname with title title, dated MMYY, optionally version-numbered NN.

Upload a file to the 802.1 website

When uploading files to the 802.l website, please name your file according to the conventions above. Files which don't follow the conventions will be rejected by the task group chair. Your file will be uploaded to the private contributions area pending correct placement by the task group chair. Other participants can download it from there, but the file will be moved to its proper place in due course. When uploading a file, please provide a brief description, which will one day be used on the website. Here is the upload form.


Pages copyright © Institute of Electrical and Electronics Engineers, Inc. Please read the rules on Confidentiality Statements and Copyright Notices on Communications. Information on Privacy and opting out of cookies is available. If you have any comments on these pages, please send them to me.

Valid XHTML 1.0 Transitional Valid CSS!

Last modified by jlm, at 9:27am on Thu, 10 Sep 2009