Worklog Maintenance Guide

Maintenance Guide

Adding a New Education Domain

  1. Create partials/worklog/education/<domain>.adoc with tracker includes

  2. Add include::partial$worklog/education/<domain>.adoc[] to education.adoc assembler

  3. Build: make 2>&1 | grep -E 'WARN|ERROR'

Example — adding RHCSA:

// partials/worklog/education/rhcsa.adoc
// Worklog Education: RHCSA
// Usage: Included by worklog/education.adoc assembler

=== RHCSA 9 (EX200)

include::partial$trackers/education/rhcsa.adoc[tag=status]

Removing a Completed Domain

  1. Comment out or delete the include:: line in the assembler

  2. Optionally delete the sub-file (or keep for history)

  3. No worklog template changes needed

Swapping Morning Focus

  1. Edit partials/worklog/morning/focus.adoc with new content

  2. No assembler or template changes needed

Silencing Sections on Weekends

Comment out lines in the assembler. Example for work-chla.adoc:

== Work (CHLA)

// \include::partial$worklog/work/timekeeping.adoc[]
include::partial$worklog/work/projects.adoc[]
include::partial$worklog/work/priorities.adoc[]
// \include::partial$worklog/work/tickets.adoc[]

Adding a New Urgent Domain

  1. Create partials/worklog/urgent/<domain>.adoc

  2. Add to urgent.adoc assembler

  3. The domain automatically appears in every future worklog

Adding a New Tracker Concern to Work

  1. Create partials/worklog/work/<concern>.adoc with tracker includes

  2. Add to work-chla.adoc assembler

Carryover Table Maintenance

Adding a new carryover item:

Add a row to partials/trackers/work/adhoc/carryover.adoc with today’s date as Origin. The update-carryover-days.sh script will auto-calculate Days on next make new-day.

Resolving a carryover item:

Move the row from carryover.adoc to resolved.adoc with the resolution date.

Monthly Rollover

At the start of each month:

  1. Ensure the month header exists in partials/nav/chronicle-YYYY.adoc:

    ** May
*** xref:2026/05/index.adoc[Month Overview]
*** Worklogs

  2. Create pages/2026/05/index.adoc with standard header and == Worklogs section

  3. make new-day handles everything else