Write Your First Article

This tutorial walks you through creating your first KMS article — a real briefing note on a South Australian government relations scenario. By the end, you'll have a published article on the knowledge base.

What You'll Build

A briefing note titled "SA State Budget 2026-27: Health Portfolio Analysis" — a concise analysis of budget allocations relevant to healthcare clients.

Before You Start

Make sure you have:

  • [ ] Access to the Sveltia CMS at /admin/ (authenticated via GitHub)
  • [ ] A GitHub account with write access to the kamirostami-lab/aces-prime repository
  • [ ] Completed the Quick Start Guide for system context

Time Required

Approximately 20 minutes from blank page to published article.

Step 1: Open the CMS

Navigate to /admin/ in your browser. You'll see the Sveltia CMS dashboard:

  1. If prompted, authenticate with GitHub — this grants the CMS permission to commit files to the repository
  2. Once authenticated, you'll see the collections sidebar on the left
  3. Click "Knowledge Base" in the collections list

You should now see the knowledge base entries — including this documentation suite.

Step 2: Create a New Article

  1. Click the "New Knowledge Base" button (usually at the top of the collection view)
  2. The CMS creates a new entry with default front matter — the status is automatically set to draft

Safety Check

Your new article is already in draft status. It won't appear on the live site until you explicitly change status to published. You can write, edit, and preview freely without risk of accidental publication.

Step 3: Fill In the Front Matter

Replace the default front matter with the following. Each field is explained below.

---
title: SA State Budget 2026-27 — Health Portfolio Analysis
status: draft
date: 2026-04-30
author: Your Name
category: Government Relations
subcategory: State Budget
content_type: Briefing Note
difficulty: Intermediate
excerpt: Analysis of the 2026-27 SA State Budget health portfolio allocations, implications for healthcare-sector clients, and recommended engagement strategies.
tags_list:
  - sa-budget
  - health
  - government-relations
  - briefing
---

Field Explanations

Field What to Enter
title The article headline. Use sentence case — capitalise only the first word and proper nouns
status Leave as draft for now. You'll change it to published in Step 8
date Today's date in YYYY-MM-DD format
author Your name as it should appear on the article
category Government Relations — this article is about government budget analysis
subcategory State Budget — a finer-grained label within Government Relations
content_type Briefing Note — this is a concise executive summary
difficulty Intermediate — assumes some familiarity with SA government structure
excerpt A one-sentence summary. This appears on the knowledge base index page and in search results
tags_list Keywords for filtering and search. Use lowercase, hyphen-separated multi-word tags

Full Field Reference

Every field is defined in the Glossary. For writing conventions (capitalisation, voice, tone), see the Style Guide.

Step 4: Write the Article Body

Now write the content. Below the front matter, add the following body. This is a complete briefing note you can adapt.

## Executive Summary

The 2026-27 SA State Budget allocates $8.2 billion to the health portfolio — a 4.7% increase on the previous year. Key areas of relevance to healthcare-sector clients include expanded telehealth funding, aged-care infrastructure grants, and the ongoing Health Performance Council reform agenda. This briefing identifies the three most significant budget measures, assesses stakeholder sentiment, and recommends engagement priorities.

## Key Budget Measures

### 1. Telehealth Expansion — $47M over 4 years

The government has committed $47 million to expand telehealth services beyond metropolitan Adelaide into regional and remote communities. This creates immediate procurement opportunities for digital health platforms, remote monitoring devices, and virtual care workforce solutions.

**Implications for clients:**
- RFPs expected Q3 2026 for telehealth platform providers
- Preference for interoperable solutions aligned with My Health Record
- Regional deployment targets require local partnership structures

### 2. Aged-Care Infrastructure Fund — $210M

A new $210 million capital works fund targets aged-care facility upgrades, including a mandatory transition to smart-building standards by 2028. This is the single largest health infrastructure commitment in this budget cycle.

**Implications for clients:**
- Construction, facilities management, and health-tech sectors directly affected
- Smart-building standard creates compliance pathway for technology providers
- Competitive grant process — applications open August 2026

### 3. Health Performance Council Reform

The HPC's remit has been expanded to include private-sector service delivery performance. This represents a significant regulatory shift — private providers will now be benchmarked against public-sector standards.

**Implications for clients:**
- New reporting requirements for private healthcare providers
- Potential reputational exposure from public benchmarking
- Opportunity to engage early and shape reporting methodology

## Stakeholder Sentiment

| Stakeholder | Position | Priority |
|------------|----------|----------|
| SA Health | Supportive — driving the telehealth expansion directly | High |
| Opposition | Cautious — questioning aged-care funding adequacy | Medium |
| AMA (SA) | Supportive of telehealth; neutral on HPC reform | Medium |
| Aged Care Providers Association | Strongly supportive of infrastructure fund | High |
| Private Hospitals Association | Concerned about HPC benchmarking scope | High |

## Recommended Engagement

1. **Immediate (next 2 weeks):** Brief telehealth-sector clients on the $47M allocation and upcoming RFP timeline. Prepare capability statements aligned with My Health Record interoperability requirements.

2. **Short-term (next month):** Register client interest in the aged-care infrastructure grant program. Begin pre-application consultations with SA Health's capital works division.

3. **Medium-term (Q3 2026):** Develop a submission to the HPC's expanded methodology consultation. Position clients as constructive participants in the performance benchmarking framework.

## Key Contacts

- **SA Health — Capital Works Division:** Director, Infrastructure Grants
- **Department of Premier and Cabinet:** Health Policy Unit
- **HPC Secretariat:** Consultation inbox (submissions due September 2026)

> [!note] Source
> Budget figures sourced from the SA Government Budget Paper 3, released 19 June 2026. All allocations are confirmed. Stakeholder positions are based on public statements and direct engagement.

Copy and Adapt

The briefing above uses realistic scenario data. Replace names, figures, and dates with real information when writing actual client briefings. The structure (Executive Summary → Key Measures → Stakeholder Sentiment → Recommended Engagement → Contacts) is a proven format for government relations briefing notes.

Step 5: Set Display Options

Scroll back up to the front matter and add these optional fields to enhance the article's presentation:

table_of_contents: true
featured_image: /assets/repository/images/uploads/your-image.jpg
image_alt: SA Parliament House
  • table_of_contents: true — Auto-generates a clickable TOC from your H2/H3 headings
  • featured_image — A hero image for the article (optional; upload via the CMS media library)
  • image_alt — Descriptive alt text for accessibility and SEO

Step 6: Preview Your Article

  1. Save the article in the CMS (Ctrl+S or Cmd+S, or use the Save button)
  2. The CMS commits your changes to the repository
  3. In your local development environment, run npm start to launch the Eleventy dev server
  4. Navigate to http://localhost:8080/staff/knowledge/sa-state-budget-2026-27-health-portfolio-analysis/

You should see your article rendered with:

  • A table of contents (left side of the content area)
  • Properly styled headings, tables, and the callout at the bottom
  • A breadcrumb trail showing: Staff Portal → Knowledge Base → Government Relations → article title

Draft Visibility

In development (localhost), you can see the article even though it's a draft. On the production site, drafts are invisible. This is by design — it lets you preview your work safely.

Step 7: Review Against the Style Guide

Before publishing, check your article against the Style Guide:

  • [ ] Title uses sentence case
  • [ ] Excerpt is one sentence, under 160 characters
  • [ ] Headings use H2 for sections, H3 for subsections
  • [ ] One callout used appropriately (note for the source reference)
  • [ ] Table has a header row and is readable at mobile widths
  • [ ] Numbers use comma separators (47,000,000 → $47M in context)
  • [ ] Australian English spelling (organisation, not organization)

Step 8: Publish

When you're satisfied:

  1. Change status from draft to review
  2. Ask a colleague to review the article (optional but recommended — see Review & Publish Workflow)
  3. After review, change status to published
  4. The article goes live on the next production build (triggered automatically when changes are pushed to the main branch)

Congratulations

You've created and published your first KMS article. From blank page to live briefing note in under 20 minutes.

What You Learned

Skill Where to Learn More
Creating articles in Sveltia CMS Using the CMS
The draft→review→publish workflow Review & Publish Workflow
Front matter field definitions Glossary
Copy-paste templates for other content types Content Templates & Examples
Writing conventions and formatting standards Style Guide

Practice Exercise

Create a second article on your own — a Policy Analysis on an upcoming regulatory change in your practice area. Use the Policy Analysis template from Content Templates & Examples as your starting point. Set it to draft status, write a full first draft, then change it to published when ready.