PRONOM_Research has been created so that there is a permanent GitHub repository for collaboration. This could include research submissions, issues, improvements, submitting samples or using/ collaborating on resources.
We want those who use and submit to PRONOM to have a better understanding of the work we do on a daily basis. Therefore we have created an area to which we shall upload the test signatures we are working on, on a weekly basis and a spreadsheet where you can view the progress of the next release.
If there is an issue, or you have some research to submit then this GitHub area is a good place to start. There are two options available to you, the first is to raise an issue (perfect for suggestions and improvements) or to create a pull request (perfect for file changes, uploading research and improvements to this repository). For both of these actions you will need to be registered for a GitHub account.
We have an issue area with templates for different types of issue you may wish to raise. If you are new to GitHub or not raised an issue before, then guidance can be found here.
If you wish to upload research into our submissions area, or wish to make improvements to the repository then submitting a pull request would be the better option. If you are new to GitHub or not created a pull request before, then guidance can be found here.
PRONOM has a Google Group where you can join discussions, post queries and receive updates on our work. It is also useful if you would like help or advice on conducting your research, crafting your submission, creating a signature, or if you're having difficulty finding samples.
If you are not sure where to start with file format research, then this could be the perfect place to start. If you have cataloguing and research skills, then working on descriptions in the PRONOM database could be for you, no technical expertise is required. Many of the file formats in PRONOM do not have a proper description, they only have what we call 'Outline Descriptions', therefore the team have set up an online spreadsheet to help tackle this issue.
PRONOM is very much a community project and we are trying to encourage more collaboration online via our GitHub, GoogleGroups and Google Sheets. However there can be many reasons why you may not wish to use these tools to contact us. For example file samples you may not wish to share online but send directly to us. If this is the case then do contact us at PRONOM@nationalarchives.gov.uk, and we will do our best to respond within 10 working days.
The PRONOM Team run Open Drop-In sessions every two weeks on a Thursday, if you have any queries, wish to meet the team or other community members then please drop by and say hi. The meeting is open format, and the agenda is determined by what users wish to talk about. There is also no pressure to talk during the meetings, you are welcome to come along and listen. Further details can be found here.
For each submission, please include as much of the following information as possible. It's okay if you don't have everything, but please include what you can:
- Format name - Use the official name where known. Please capitalise each word unless the format name is stylised in some alternative way, e.g. Apple iBook.
- Version number (where relevant)
- PUID - if it exists already and you're providing an enhanced description.
- Extensions - any extensions known to be associated with the format.
- MIME/Media Type - the MIME or Media Type associated with the format. A brief description of what a MIME type is can be found here. This should be an official Media Type, either registered and listed via the IANA or listed in official format documentation produced by the vendor. The best way to search IANA is to find in page and search for key words of the format.
- Description - a concise, objective description of the file format.
- Format type - What type of format is it (see below)?
- Vendor (if known) - which vendor created the format? Which vendor currently supports it?
- File format identification signatures (for the brave!).
- Attribution
We like to credit all submissions on our Release Notes page. You can be credited as an individual or we can credit your institution. We also keep track of international contributions via the contributors map so please let us know how you'd prefer to be credited.
Format descriptions must be objective - avoid using phrases like "This is the best format for…" and avoid comparisons with other formats.
The current list of format classifications within PRONOM are:
- Audio
- Database - the formats of database software, such as MS Access, MySQL
- GIS - Geographic Information System (geospatial data formats)
- Image (Raster) - images based on pixel grids, such as JPG, GIF, PNG
- Image (Vector) - images based on mathematical primitives, such as SVG, Adobe Illustrator, CorelDraw, WMF
- Page Description - the language of printers. Examples include HP-GL, PDF, PostScript
- Presentation - such as Powerpoint, Impress, Apple Keynote
- Spreadsheet
- Text (Unstructured) - plain text formats with no formal structure
- Text (Structured) - plain text formats with defined, regular structure
- Text (Mark-up) - such as XML, SGML, MD
- Word Processor
- Video
- Aggregate - such as zip, WARC, 7z, rar, iso
- Dataset - structured forms of data
- Model - 3d formats such as CAD and 3d models
- Font
Your format may not easily fit into any of the above categories, so feel free to reach out for advice!
- The main PRONOM website can be found here: www.nationalarchives.gov.uk/PRONOM.
- Ross Spencer's signature development utility for both binary and container signatures can be found here.
- A list of blogs, presentations, and other resources to assist with PRONOM research and file format signature development can be found here.
- If you would like help or advice on conducting your research, crafting your submission, creating a signature, or if you're having difficulty finding samples, please create a conversation thread on our Google Group.
- Here is the full list of everything in PRONOM as of the v108 release on 5 September 2022. From here you can see which formats don't currently have MIME/Media types, lists of associated extensions, deprecated formats and formats that have signatures (including container signatures).
- Here is a list of PUIDs that currently lack signatures. Can you help sourcing example files and suggesting potential identification signatures?
- Here is a list of PUIDs that currently only have an 'outline' description. Can you help us with some suggestions for PRONOM descriptive text entry? Descriptions should be objective descriptions of what the format does and can include information about its originating software and so should not contain qualitative information, such as '...is the best format for...'.
- Here is a list of files which we are looking for samples of, or information about. Can you help by providing some, or point us in the direction of where we can find them?
PRONOM data is published under the Open Government License 2.0 so please ensure you are happy with the terms of this license before submitting any descriptive information.
All samples shared here are available under Creative Commons CC0 unless otherwise stated. Please ensure you have the right to share any samples you wish to submit, and that you are happy to share these under CC0 license.
You may prefer to submit your samples to the larger OPF Format Corpus.
Alternatively, if you need your samples to remain private or are unhappy with the licensing terms of this repository, you can submit them directly to the PRONOM mailbox: pronom@nationalarchives.gov.uk - samples submitted via the mailbox will not be shared online and we can provide a formal NDA if required. We will use these solely for the purpose of file format research and signature validation.
The PRONOM team are dedicated to providing a harassment-free experience for everyone, regardless of gender, gender identity and expression, sexual orientation, disability, physical appearance, body size, age, race, or religion. We do not tolerate harassment of participants in any form.
This code of conduct applies to all pronom-reseach spaces, including Google Docs, Google Groups, our GitHub repository, and e-mails, both online and off. Anyone who violates this code of conduct may be sanctioned or expelled from these spaces at the discretion of the RESPONSE TEAM (can be reached at pronom@nationalarchives.gov.uk).
Some pronom-research spaces may have additional rules in place, which will be made clearly available to participants. Participants are responsible for knowing and abiding by these rules.
This anti-harassment policy text has been taken and modified from https://geekfeminism.wikia.org/wiki/Community_anti-harassment/Policy.