To engage your customers, consider adding file attachments and images to your documentation. Here's how.
Drag and drop your files
Adding file attachments to your MindTouch articles is super easy. As in—just drag and drop. Once you've dragged an attachment into the editor, two things happen:
- The file is uploaded and attached to the current page. In other words, the new file is now physically stored on the page. (See a list of attachments at the bottom of the page.)
- The file attachment is then referenced in the body of the page. If the file is something like a Microsoft Word .doc or a PDF, MindTouch creates a link to download the file. If the file is an image, the image is simply embedded in the body of your page:
Okay, but how do I update these in the future?
As long as the filename does not change, simply drag the file into the page—you don't even have to be in the editor itself. On file upload, MindTouch marks the file with a new revision.
The best part? Just refresh the page. When an attachment is referenced in the body of a page, MindTouch always refers to the latest version. Your link to download the PDF (or embedded image) is instantly updated.
We know—we love it, too.
► Review our extended documentation
Best practice: media repo
In the long-term, we recommend setting up a media repository that provides you a central location to store all file attachments. Why? Managing file attachments across an entire site can be cumbersome, especially when it comes time to update them. If all attachments are in a central repository, you can then single-source a file attachment to be used in several locations.
The best part? As mentioned above, if you update a single-sourced file attachment, all invocations of that file attachment are instantly updated.
► Set up a media repository