Categorizing resources

Purpose: Describe how resource categories and subjects work, for reference for developers and designers.

Categories and subcategories

Resources can be assigned to categories and subcategories, which can help users understand what what kind of resource a document is. See the Resources linking page for how this affects content and display of resources.

Category hierarchy

The top-level categories and subregulatory guidance subcategories should be arranged in order of authoritativeness.

We add and update categories as we work on the content; the following list is an example.

• Statutes
• Federal Register Documents (groups of documents, sorted in date order by the most-recently-published document that each group contains)
• Related Regulations
• Subregulatory Guidance
  • State Medicaid Director Letter (SMDL)
  • State Health Official Letter (SHO)
  • CMCS Informational Bulletin (CIB)
  • Frequently Asked Questions (FAQs)
  • State Medicaid Manual (SMM)
• Implementation Resources
  • State Plan Amendment Resources
  • Technical Assistance for States
  • Templates
  • Toolkits
  • Waiver Resources
  • Other Resources

Configuration of categories and subcategories

Our admin panel enables team members to:

• Create, rename, and delete categories and subcategories
• Associate a subcategory with a parent category
• Add text descriptions for categories, to be displayed under the category name (subcategories don't display descriptions)
• Determine the placement of a category or subcategory in the list, by giving it a numerical value for its order (for example, a category with a weight of "1" would show up first in the list, and a category with a weight of "1000" would show up last)

Subjects

Resources can also be assigned any number of subjects, which can help users research a topic. See the Resources linking page for how this affects content and display of resources. Subjects do not have a hierarchy. A list of all subjects makes up the sidebar navigation on the Find by Subject page.

Our admin panel enables team members to:

• Create, rename, and delete subjects
• Assign a short name or abbreviation to a subject that people might know by different names
• Add text descriptions for subjects to help editors use them appropriately