From 5b6575ae8ebc31617c123a253cc3370fbbe1245e Mon Sep 17 00:00:00 2001 From: 4gl <@> Date: Mon, 10 Aug 2026 18:42:49 +0100 Subject: [PATCH] fix: small edits + ai notes --- .ai/skills/linkedin.md | 48 +++++++++++++++++++ .../zero-code-business-data-capture/index.md | 4 +- 2 files changed, 50 insertions(+), 2 deletions(-) create mode 100644 .ai/skills/linkedin.md diff --git a/.ai/skills/linkedin.md b/.ai/skills/linkedin.md new file mode 100644 index 0000000..90b49c5 --- /dev/null +++ b/.ai/skills/linkedin.md @@ -0,0 +1,48 @@ +# LinkedIn Post Writing Guide + +Guidance for drafting LinkedIn posts promoting Data Controller (datacontroller.io). + +## Audience + +Our readers are typically: + +- **Technical managers and platform owners** in regulated industries (Banking, Insurance, Pharma) running enterprise SAS® estates. +- **Data governance / data quality leads** dealing with End User Computing (EUC) risk and audit requirements. +- **SAS developers and administrators** who maintain data pipelines and care about automation, security and auditability. +- Occasionally **C-level / procurement** - keep business value (OpEx, risk reduction, compliance) visible alongside technical detail. + +Implications: + +- Assume competence - no need to explain what ETL, SAS, or a data warehouse is. +- Speak to their pains: regulatory reporting deadlines, audit trails, hand-cranked ETL, EUC sprawl, OpEx, blame-games between business and IT. +- Professional but direct tone. Avoid hype, buzzword stuffing, and exclamation-mark overload. + +## Structure + +1. **Hook** - first 1-2 lines must stand alone; LinkedIn truncates the rest behind "…see more". State the pain or the claim, not the product. +2. **Problem** - short paragraphs describing the pain in the reader's context. +3. **Belief / shift** - what we believe the world should look like. +4. **Solution** - introduce Data Controller, one or two sentences on what it does (zero-code data capture, review/approve workflow, audit trail, loads into SAS / any database). +5. **Outcome** - the concrete result (eliminated ETL flows, reduced OpEx, full lineage). +6. **CTA** - single call to action, typically "book a Discovery Call - link in the comments below 👇". LinkedIn deprioritises posts with external links, so put URLs in the first comment, not the body. + +## Formatting rules + +- **Hashtags are written as `#tag`** (e.g. `#endusercomputing`, `#excel`, `#datagovernance`, `#sas`, `#masterdata`). Never write `hashtag#tag` - that is an artefact of copy-pasting from LinkedIn's editor UI and must be stripped/normalised to `#tag` before posting or republishing. +- 3-5 hashtags, all lowercase, placed at the end on their own lines. +- Use regular dashes (`-`), not em-dashes (`—`). +- Short paragraphs (1-3 sentences) with blank lines between them - LinkedIn has no markdown. +- No markdown syntax (no `**bold**`, no `[links](url)`) - LinkedIn renders plain text. Use CAPS sparingly for emphasis instead. +- ® symbol on first mention of SAS® is fine; don't repeat it every time. +- Keep total length under ~1,300 characters where possible; longer posts are fine when the story warrants it, but the hook still has to earn the "see more" click. + +## Media + +- Always attach an image - posts with images get substantially more reach. Use the same image as the feed post's `previewImg` where one exists. +- Product screenshots work well for feature announcements; flat branded illustrations for thought-leadership posts. + +## Relationship to the site Feed + +- Feed posts (`content/feed/`) and LinkedIn posts are siblings, not copies: the site version may contain markdown links and omits hashtags; the LinkedIn version uses plain text, `#tag` hashtags, and "link in the comments". +- When converting site → LinkedIn: strip markdown, convert links to a comment-based CTA, append hashtags. +- When converting LinkedIn → site: strip `hashtag#` artefacts and hashtags, add proper markdown links, add front matter per the `add-feed-post` skill. diff --git a/content/feed/zero-code-business-data-capture/index.md b/content/feed/zero-code-business-data-capture/index.md index cd235ef..c610497 100644 --- a/content/feed/zero-code-business-data-capture/index.md +++ b/content/feed/zero-code-business-data-capture/index.md @@ -9,7 +9,7 @@ tags: previewImg: './zero-code-business-data-capture-for-sas.jpeg' --- -As the technical manager of an enterprise data platform in a regulated environment such as Banking or Insurance, you need to deliver outputs in a consistent and timely fashion to meet statutory and management reporting demands. +As a member of a Data & Analytics team in a regulated sector such as Banking or Insurance, you need to deliver outputs in a consistent and timely fashion to meet statutory and management reporting demands. In order to do that, your team builds and maintains automated processes that capture, cleanse and integrate with centrally managed Data Warehouses. @@ -17,7 +17,7 @@ The problem when capturing data created by business users (as opposed to IT-secu This can result in 'blame-games' and delays in data delivery. -We strongly believe that loading business data to IT-controlled databases should be simple, secure, and FAST. +We strongly believe that loading business data to IT-controlled databases should be simple, secure, and fast. That's why we created Data Controller for SAS® - a unique zero-code solution for capturing business data at source and moving it safely and securely into your IT-managed data store.