Posting Documents - Best Practices

*This page assumes you have already been trained on the basics of uploading documents to the Sociology website by the A&S team.  Please complete this training before editing the Sociology site.

For resources on digital accessibility, please see resources from the ADA Accessibility Initiative.

Does this document or form absolutely need to be a document of some kind, or can it be built as a regular web page?

If it can be built as a regular web page, instead of a PDF or a Word document, this is by far superior for accessibility reasons regarding screen readers. It is also much easier than trying to make a document accessible for a screen reader. Even forms can likely be built as a regular web page. 

Document Name Matters - Make It Generic!

This helps us from having outdated documents on the site.

Before posting, save the document as a new file, with a generic name, in the file location where we keep copies of the files with generic names. 

Do not post documents that have names with dates in them etc. that would make them hard to update and replace at a later date.

If posting a new version of an already existing document:

  • First, go to the website, and find the existing document.
  • Find out how the document is already named in the site, you'll need that information.
  • Re-save the new version of the file you have been given to update with the Generic Name, in the saved file names area.
  • Upload the new version of the file, but with the Generic Name (see explanation below), to the website, replacing the earlier version, in the same file folder within the file directory as the original version.

Posting a brand new document:

For instance, you are given or create a document that needs to be posted, named, FooBar_08-17-2017.pdf, just as an example. 

  • Re-save the file into the shared server area being kept with generically named documents, changing the name to a recognizable name, but without a date, perhaps Foobar.pdf, entirely removing the date.
  • While editing, click on the "make it a link' icon, and a box comes up with the specifics of the link programming information.
  • To the right, there is a tiny file folder icon (looks like a box), click on that and the file server will pop up in a new window.
  • Pick the appropriate sub-folder to upload your file to, and upload your file. 
  • Complete the rest of the programming parameters in the box, and click save. You have a new link, congratulations!

Why take the time to do this?

A web site does not think.  It will only do what you tell it to do.  So if you upload a document call FooBar_08-17-2017.pdf, and then you need to upload a new version later, say FooBar_10-25-2018.pdf, when you upload the 2nd document you end up with BOTH documents on the site.  This is bad for multiple reasons:

  • On the page you have replaced the old document with the new document, this is the ONLY page/link that will be fixed.
  • All the other links on other pages that go to the document will still be pointing to the old one FooBar_08-17-2107.pdf, and now all of sudden we have 2 versions of the file on the site, and different pages pointing to different files, one of which is outdated.
  • People can search our site with the Google search, and they might end up pulling up the old document, not the updated one, this is not good either.
  • With a file that is not generically named, to avoid this, you'd have to:
    • Track down each and every link on the site on any page and replace the document with the new one.
    • AND delete the old document in the files area itself or it could still be found with the Google Search.
    • This is really painfully tedious, and often it's hard to find all the links - there is no tool that says this file is on these specific pages available to us in this Drupal site.

But if we remember to ALWAYS use a generically named document, e.g., FooBar.pdf, the newly named generic document in our example, then:

  • Go to the link you want to update with the new file, generically named, just like the old file, so also named "FooBar.pdf" per the example we've been using here.
  • Update that link, but updating the new file, and recording over the old version of the file, with a file of the same name.
  • Effectively, you have then updated the file for the entire site, all at once!  And you don't have to find additional links to fix them.
  • This also effectively deletes old version, making them unavailable to a Google search.
Share