Managing Departments

Department records live in _data/departments.yml. They supply the department list, detail pages, staff groups, sitemap, and footer links.

Set up a department

Add or edit a record

example:
  path: /departments/example
  staff_department: Example
  en-us:
    name: Example Department
    bio: Responsible for the example area of PWindows.
  zh-cn:
    name: 示例部门
    bio: 负责派视界的示例领域。

Every department needs path and staff_department. Every configured language also needs its own name and bio.

• example: is the department's unique key.
• path is its unique public address.
• staff_department connects staff profiles to the department and must be unique.
• Each localized bio is the public description shown in that language.
• Language keys must match _config.yml; see Localization.

Add the detail page

Every department record needs a matching file in pages/departments/:

---
layout: department
title: Example Department
permalink: /departments/example
description: Learn about the example department at PWindows.
intro: Learn what the example team contributes to PWindows.
department: example
---

Three values must agree:

• department: example matches the example: data key;
• permalink: /departments/example matches the data record's path;
• layout remains department.

The shared layout automatically displays the department biography and matching team members.

Empty teams

If a department has no public staff profiles, keep the message explaining that no team members are listed. Do not add placeholder people to hide the empty state.

Verify the department

Check the result

• Open /departments/, /zh-cn/departments/, and both versions of the department detail page locally.
• Check its name, biography, link, and team list.
• Check the footer and /sitemap page.
• Run Running Checks.

Return to Managing Site Data.