Skip to content
Avatar
Block or Report

Block or report ljsinclair

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Add an optional note:
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
ljsinclair/README.md

Wiki | Contact | Linkedin

I'm LJ Sinclair, and I'm a writer

That sounds like the opening spiel to an addiction confession, doesn't it? And in my case, there's some truth to that. I get quite twitchy if I go too long between arranging words in a pleasing order. And there's no twelve-step programme for this kind of addiction, let me tell you.

The right word, in the right place, at the right time

Anyone can type words into a word processor, email or social media with mixed results.

But to communicate meaning without ambiguity, you need someone who knows how to:

  • establish the facts through direct research and working with subject matter experts
  • determine the audience
  • turn complex, ambiguous ideas into clear, easy to understand content
  • and do all this without leaning into the tropes of marketing, hard sell or manipulation

To paraphrase Charlie Taub (Vadim Glowna) in the Jack Irish movies:

Technical Communication is to Writing what Software Engineering is to Programming.

But why isn't it pretty?

A good User Experience (UX) is one where the audience gets the information they need when they need it.

That's why I chose GitHub for a homepage, because it's clean and minimalistic (not to mention I can write content in Markdown).

That isn't to say I don't appreciate good design that:

  • prioritises usability and accessibility for the audience
  • helps the audience find what they need as quickly and efficiently as possible
  • is tested to verify these are the case.

But it's far too easy to find sites and software that:

Current tasks

This is a public-facing Kanban project containing tasks that is kept up-to-date as required.

Past projects

You can find a full breakdown and summary of past projects and work on my LinkedIn profile:

Here's some highlights:

Project name Description Tools Finish date
Zendesk engineering docs dogfooding their own Help Center tool for engineering documentation. Zendesk Guide, Github markdown, Confluence, Google Docs 2022-06-30
mamori.io docs Tutorial/help system for the mamori.io security product Jekyll, Zola, GitLab July 2021
uEducateUs website Copywriting and website for the uEducateUs product Jekyll, BitBucket Jan 2021
uEducateUs knowledgebase KB for the uEducateUs product Confluence Jan 2021
AAWP website Restore site after catastrophic failure, document issues, recommend solutions and help implement solutions Wordpress 2021

Changelog

Version Date Changes
2.0 2022-06-13 Rewritten content to be less glib, created projects, cut old material
1.0 2021 First published

Popular repositories

  1. Public facing github pages website pour moi

  2. docs Public

    Forked from github/docs

    The open-source repo for docs.github.com

    JavaScript

25 contributions in the last year

Oct Nov Dec Jan Feb Mar Apr May Jun Jul Aug Sep Mon Wed Fri

Contribution activity

October 2022

ljsinclair has no activity yet for this period.

Seeing something unexpected? Take a look at the GitHub profile guide.