{
    "version" : "https://jsonfeed.org/version/1",
    "content" : "news",
    "type" : "single",
    "title" : "The Content Corner: Helping Your Content Contributors |Digital.gov",
    "description": "The Content Corner: Helping Your Content Contributors",
    "home_page_url" : "/preview/gsa/digitalgov.gov/bc-archive-content-3/","feed_url" : "/preview/gsa/digitalgov.gov/bc-archive-content-3/2015/10/19/the-content-corner-helping-your-content-contributors/index.json","item" : [
    {"title" :"The Content Corner: Helping Your Content Contributors","summary" : "Recently, I shared some suggestions and personal lessons learned for agencies either shopping for a new CMS or preparing to revamp their content strategy and workflow. Let’s take things one step further and focus on arguably the most important parts of your CMS: the content creator or user. Arguments can be made that content is the most","date" : "2015-10-19T10:04:17-04:00","date_modified" : "2025-01-27T19:42:55-05:00","authors" : {"tyrus-manuel" : "Tyrus Manuel"},"topics" : {
        
            "content-strategy" : "Content strategy",
            "content-strategy" : "Content strategy",
            "design" : "Design",
            "user-experience" : "User experience"
            },"branch" : "bc-archive-content-3",
      "filename" :"2015-10-19-the-content-corner-helping-your-content-contributors.md",
      
      "filepath" :"news/2015/10/2015-10-19-the-content-corner-helping-your-content-contributors.md",
      "filepathURL" :"https://github.com/GSA/digitalgov.gov/blob/bc-archive-content-3/content/news/2015/10/2015-10-19-the-content-corner-helping-your-content-contributors.md",
      "editpathURL" :"https://github.com/GSA/digitalgov.gov/edit/bc-archive-content-3/content/news/2015/10/2015-10-19-the-content-corner-helping-your-content-contributors.md","slug" : "the-content-corner-helping-your-content-contributors","url" : "/preview/gsa/digitalgov.gov/bc-archive-content-3/2015/10/19/the-content-corner-helping-your-content-contributors/","content" :"\u003cdiv class=\"image\"\u003e\n  \u003cimg\n    src=\"https://s3.amazonaws.com/digitalgov/_legacy-img/2015/10/600-x-400-Woman-typing-on-laptop-Jupiterimages-Stockbyte-Thinkstock-86541717.jpg\"\n    alt=\"Woman typing on laptop.\"/\u003e\u003c/div\u003e\n\n\n\u003cp\u003eRecently, \u003ca href=\"/preview/gsa/digitalgov.gov/bc-archive-content-3/2015/10/05/the-content-corner-content-management-system-considerations/\"\u003eI shared some suggestions and personal lessons learned\u003c/a\u003e for agencies either shopping for a new CMS or preparing to revamp their content strategy and workflow.\u003c/p\u003e\n\u003cp\u003eLet’s take things one step further and focus on arguably the most important parts of your CMS: the content creator or user. Arguments can be made that content is the most important, but the user creates that content, so either way we have a tight first and second most important ranking.\u003c/p\u003e\n\u003cp\u003eBy applying some good \u003ca href=\"/preview/gsa/digitalgov.gov/bc-archive-content-3/2014/07/07/user-experience-ux-vs-customer-experience-cx-whats-the-dif/\"\u003euser experience\u003c/a\u003e practices, you can help make your content creator’s job as easy as possible and also ensure you get the best content as efficiently as possible.\u003c/p\u003e\n\u003ch2 id=\"content-contributors-are-users-too\"\u003eContent Contributors Are Users Too\u003c/h2\u003e\n\u003cp\u003eMaybe everyone else gets this and I am showing scars from bad CMS implementations in my past, but I still feel like this point cannot be made enough. In several of my past CMS implementations, the content contributors have been discounted because they are “staff” and are not given the same consideration as we would for external users completing an online form. But a CMS is essentially an online form for your internal users and its ease of use should be given the same priority as your results from an \u003ca href=\"/preview/gsa/digitalgov.gov/bc-archive-content-3/2014/11/10/4-tips-on-great-survey-design/\"\u003eexternal survey\u003c/a\u003e.\u003c/p\u003e\n\u003cp\u003eAt \u003ca href=\"http://uscourts.gov\"\u003emy agency\u003c/a\u003e, we have recently wrapped up a project to streamline the CMS form our court HR representatives use for internal job postings.\u003c/p\u003e\n\u003cp\u003eAfter \u003ca href=\"/preview/gsa/digitalgov.gov/bc-archive-content-3/2013/06/28/6-way-to-improve-web-user-experience/\"\u003euser interviews\u003c/a\u003e, \u003ca href=\"/preview/gsa/digitalgov.gov/bc-archive-content-3/2014/08/08/design-sketching-the-easiest-prototype-method-ever/\"\u003ewireframing\u003c/a\u003e and a recent migration to a Drupal CMS, we were able to really simplify the job posting process for this group of content contributors dispersed across the country (and U.S. territories).\u003c/p\u003e\n\u003ch2 id=\"field-names\"\u003eField Names\u003c/h2\u003e\n\u003cp\u003eOne of the first areas where we took user feedback and made significant improvements was the form field names. I am still amazed at how quickly jargon can creep into the form or content creation process. In the rush to get a project or a form into the hands of users, you somehow end up with things like “Advertise a Position Vacancy” instead of “Post a Job.”\u003c/p\u003e\n\u003cp\u003eThis is where exchanging information with your content contributors is key. We had several users come back and say “What does this mean?” or “Can’t it just say X?”. The initial version of the form had fallen prey to the “more complex words makes it more official and important” trap.\u003c/p\u003e\n\u003cp\u003eSome simple guidelines for naming form or content entry fields are:\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003eBe specific and describe what the field is going to be used for such as “Speaker Bio.”\u003c/li\u003e\n\u003cli\u003eKeep it simple and reflective of how the user works, not how you think they work.\u003c/li\u003e\n\u003cli\u003eFind a naming convention and stick with it.\u003c/li\u003e\n\u003c/ul\u003e\n\u003ch2 id=\"help-text\"\u003eHelp Text\u003c/h2\u003e\n\u003cp\u003eOne of the best improvements presented by our choice of the Drupal platform was the improved ability to add help text to each form field as needed. If whatever CMS you are using offers the ability to provide inline help text for your form fields, I highly recommend it.\u003c/p\u003e\n\u003cp\u003eSeveral guidelines we followed were again to keep it simple. I advocated for not providing help text for everything; simple fields would only be cluttered by unnecessary help text.\u003c/p\u003e\n\u003cp\u003eHowever, always assume that the user may be confused or is in a hurry and may not have time to think in-depth about what a field is asking for.\u003c/p\u003e\n\u003cp\u003eHelp text can act as a nudge or guide in the right direction. Our help text covered a broad range of topics including:\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003eFormatting expectations, like full URL (http://…)\u003c/li\u003e\n\u003cli\u003eNotification that the form will alter numerical input correctly, such as 45000 will become $45,000\u003c/li\u003e\n\u003cli\u003ePolicy related information, such as what will need to be done for a job posting that will remain open longer than typical.\u003c/li\u003e\n\u003c/ul\u003e\n\u003cdiv class=\"image\"\u003e\n  \u003cimg\n    src=\"https://s3.amazonaws.com/digitalgov/_legacy-img/2015/10/600-x-290-Screencap-of-an-Audience-tooltip-on-CMS-form-for-structured-content.jpg\"\n    alt=\"Screencap-of an Audience Tooltip on CMS form for structured content.\"/\u003e\u003c/div\u003e\n\n\n\u003cp\u003e\u003ca href=\"http://alistapart.com/article/training-the-cms\"\u003eThis great article on A List Apart\u003c/a\u003e goes into greater depth on help text, including various ways to assist the user when uploading images (an issue we didn’t deal with on the job form), guidance on editorial decisions (such as the suggestion to refrain from using “Click Here”) and lots of other great ways to use help text to make the user feel confident in the process and the job they’re doing.\u003c/p\u003e\n\u003ch2 id=\"provide-some-structure\"\u003eProvide Some Structure\u003c/h2\u003e\n\u003cp\u003eA final consideration that can get lost in the focus on form functionality and required fields is that the form itself is content. A user is reading and navigating the form just as they would a blog post or product description.\u003c/p\u003e\n\u003cp\u003eProviding structure to the form fields and creating groupings of fields that make sense can provide flow to the form, just as you would with an article or other content.\u003c/p\u003e\n\u003cp\u003eIn our job form, we leveraged Drupal’s field grouping to create clear sections dedicated to the main components of the job posting, such as contact information and court location. We also used a field grouping that would be closed by default, but could be expanded by a user if needed. This helps reduce clutter and confusing additional form fields that many of our users wouldn’t need to even see.\u003c/p\u003e\n\u003cp\u003eSimilar guides for the user can be created using the standard tools of \u003ca href=\"/preview/gsa/digitalgov.gov/bc-archive-content-3/2015/07/06/the-content-corner-creating-good-content-is-hard/\"\u003egood content formatting\u003c/a\u003e such as clear headings and breaking up information in a way that improves scanning.\u003c/p\u003e\n\u003cp\u003eThis type of attention to \u003ca href=\"/preview/gsa/digitalgov.gov/bc-archive-content-3/2015/07/27/the-content-corner-supporting-your-content/\"\u003econtent formatting\u003c/a\u003e is always critical, but I would argue that when you are providing instructions to a user it’s even more important, especially when the end result will become live content.\u003c/p\u003e\n\u003cp\u003eBe sure to treat your CMS as you would any Web content or product and always seek feedback from your users. Make changes, as needed, to make their jobs a little easier and make your CMS an even greater aid in implementing a consistent \u003ca href=\"/preview/gsa/digitalgov.gov/bc-archive-content-3/2015/03/23/the-content-corner-building-a-content-strategy/\"\u003econtent strategy\u003c/a\u003e.\u003c/p\u003e\n\u003cp\u003e\u003cem\u003eYou’ve just finished reading the latest article from our Monday column, \u003ca href=\"/preview/gsa/digitalgov.gov/bc-archive-content-3/topics/content-strategy/\"\u003eThe Content Corner\u003c/a\u003e. This column focuses on helping solve the main content issues facing federal digital professionals, including producing enough content and making that content engaging.\u003c/em\u003e\u003c/p\u003e\n"}
  ]
}