File naming best practises

File naming best practises

This is a topic which still crops up regularly so here's my take on it. As a very brief summary:

  1. Only ever have one instance of a document, no copies.
  2. Keep filenames short and descriptive, using spaces in-between words rather than _'s. No need for initials, 'draft'/'final', or dates (unless the document refers to a specific event).
  3. Send links to files rather than attaching copies.
  4. Let SharePoint / Teams manage the versions of the document as it's updated.
  5. Multiple people can work on a single file at the same time - this avoids mistakes and saves a huge amount of time.
  6. Don't forget to apply similar rules to your folders - keep them simple and not too many layers.
  7. Plan your folders and file-naming conventions before starting any new work, and share the rules with everyone involved.


If you're interested in the logic behind the above, here's a bit more detail:

Versioning

If you store your files in a solution like SharePoint (or, if you must, OneDrive) then version control is built in - you should therefore use it to get the benefits.

Your goal should be one version of the truth. This means that, in general, there should only ever be one instance of a document and you let SharePoint track changes made by different people. Copying documents leads to duplication and mistakes as people may refer to, or update, the wrong copy; and there will invariably be time wasted with some poor soul having to collate updates from different places.

So, do NOT:

  • Copy a file to make updates - update the original
  • Add your initials, date you've made changes, or "draft" / "final" to the filename - SharePoint can do all this for you (and when did a "Final" version of a document ever stay final?)
  • BAD: "Draft design doc - Oz comments - 3 10 23.docx"

Keeping a single source of the truth (i.e. one instance of any file) will mean that:

  • Everyone will easily be able to refer to the latest version
  • Any links to the file sent out will always lead to the latest version (not an old copy which has since been duplicated and updated)
  • Everyone will have access to previous versions to see who changed what and when
  • GOOD: "Octocopter technical design.docx" [SharePoint will provide the version, when it was created, creator, when it was last modified, and modifier]

To help with this, a SharePoint document library (or Teams Files tab, which is the same thing!) can be configured in just a few clicks to include simple Publishing functionality between minor (draft) and major (final) versions of a document.

Naming conventions

So what should we call our files? The filename should simply:

  • Let anyone who sees it know exactly what they're going to find if they open the document
  • Be as concise as possible, whilst achieving the point above

To underscore or not to underscore? - that is the question!

When we regularly had to work with the full URL (web address) of documents stored in SharePoint, replacing spaces in filenames with underscores was useful so we didn't see "%20" all over the place. However, given that we rarely see the document URL with the modern tools (SharePoint Online, Edge, and Office 365), it's best to keep things simple and just add a space between words.

What about dates?

Dates should generally only be added to a filename if the document relates to something on a specific date, such as meeting minutes or an event. When adding a date, it should be added in 'reverse chronological order'. Using a format of 'yyyy mm dd' will always show your files in chronological order. If you use 'd mm yyyy' it wouldn't (see the image at the top of the article!).

Co-authoring

By using a single file, we can also have multiple people work on a document at the same time - and others will see what you're typing almost as you type it! This is so much quicker and easier than different people working on different copies and someone having to collate all the changes into a 'master' document at the end.

Folders

It's important not to forget your folders when thinking about naming conventions. And here you have to consider structure and access as well. When kicking-off a new project, service, department, or anything else which is going to generate documentation, agree the following with key stakeholders before you start:

  • Who will need access to the documents (internal & external users)?
  • Where is it best to store them (e.g. a new Team, a new channel in an existing Team, or (rarely) somewhere else)?
  • What channel / folder structure do you need? Keep it as simple as possible, whilst providing some structure. Try to stick to a maximum of 4 levels.
  • Long folder names can cause issues so keep them short, but descriptive.
  • Have you applied the same best practises to your folders as to your files?

In summary, this is not rocket science, but setting some standards and helping your whole team to adhere to them will make for a much easier life for everyone!

A great article and I totally agree. Particularly like your reminder about why we didn't use spaces in the early years of SP and why it's ok to do so now. A good, pragmatic approach to something that is notoriously difficult to embed!

Jennifer Ruel

Clinical Trial Specialist, USA

1 年

Most recently agreed upon, Manasa Survi!

回复
Lennard Van den Berg

Always eager to learn

1 年

Oz Oscroft greay article and I agree with much you stated. But to me as an expert this is clear; however, this implies you force users to use the browser to look at their files properties. In my experience that only works for published or referenced files. If a user repeatedly is working with the same (set) of files they switch to onedrive on the client and only see properties as Windows explorer shows them. How do you handle that scenario I was wondering?

回复
Casey M.

NSE4 | NSE5 | Tripple NSE7 Certified. Networking | Hypervisor | Storage consultant.

1 年

Keep that EU Y/M/D to yourselves! Us Americans will continue with M/D/Y ????. Jokes aside, stop using spaces.

Kendal Friesen

Cloud Analyst - M365 Adoption Lead

1 年

Every good file name includes the word FINAL at least 3 times ;)

要查看或添加评论,请登录

Oz Oscroft的更多文章

  • "I need to be an Owner!!!" - SharePoint insights

    "I need to be an Owner!!!" - SharePoint insights

    One of the golden rules of cybersecurity is that people should only be given the access they need to perform their role…

    6 条评论
  • ??? Cybersecurity ≠ Data Protection ???

    ??? Cybersecurity ≠ Data Protection ???

    In our world of #ransomware attacks, #hackers, #BusinessEmailCompromise, and other #phishing attacks, it's easy to…

  • Announcing Viva Home: The Home for the Viva Suite on the Web

    Announcing Viva Home: The Home for the Viva Suite on the Web

    The following is taken from announcement MC680346 on the Microsoft 365 Message Center. MC680346 · Published 10 Oct 2023…

    3 条评论
  • Microsoft Copilot

    Microsoft Copilot

    If you follow what Microsoft is up to in even the slightest way, it will have been difficult to miss that is BIG news…

  • Private and Shared Channels in Teams

    Private and Shared Channels in Teams

    Since they were introduced, I've been wary of private channels in Teams as they're often used instead of a properly…

    3 条评论
  • Where do I get all those Microsoft icons???

    Where do I get all those Microsoft icons???

    If you love creating infographics and you work with the wonderful Microsoft ecosystem, having access to high quality…

    10 条评论
  • OneDrive - 3 tools in 1

    OneDrive - 3 tools in 1

    When I started out on my Microsoft 365 journey there were two aspects in particular which took me a while to get my…

    5 条评论
  • Microsoft Teams: Your virtual office

    Microsoft Teams: Your virtual office

    I was recently asked by someone new to Teams this simple question: Is there any Teams etiquette for new people - would…

    3 条评论

社区洞察

其他会员也浏览了