Rick Cogley RickCogley

User Stories

Reading list

[Mark Shead: Creating Good User Stories][Mark Shead]
[GOV.UK Service manual: Writing user stories][GOV.UK]
[Mike Cohn's blog posts about user stories][Mike Cohn]
[Mike Cohn: User Stories Applied (book)][User Stories Applied]

HTML Tags You Can Use on GitHub

Wherever HTML is rendered on GitHub (gists, README files in repos, comments on issues and pull requests, ...) you can use any of the HTML elements that GitHub Flavored Markdown (GFM) provides syntactic sugar for. You can either use the syntactic sugar that GFM (or other GitHub-supported markup language you're using) provides or, since Markdown can contain raw HTML, you can enter the HTML tags manually.

But GitHub also allows you to use a few HTML elements beyond what Markdown provides by entering the tags manually, and some of them are styled with CSS. Most raw HTML tags get stripped before rendering the HTML. Those tags that can be generated by GFM syntactic sugar, plus a few more, are whitelisted. These aren't documented anywhere that I can find. Here's what I've discovered so far:

`<details>` and `<summary>`

A `<detai

How to Change Open Files Limit on OS X and macOS

This text is the section about OS X Yosemite (which also works for macOS Sierra) from https://docs.basho.com/riak/kv/2.1.4/using/performance/open-files-limit/#mac-os-x

The last time i visited this link it was dead (403), so I cloned it here from the latest snapshot in Archive.org's Wayback Machine https://web.archive.org/web/20170523131633/https://docs.basho.com/riak/kv/2.1.4/using/performance/open-files-limit/

Mac OS X

To check the current limits on your Mac OS X system, run:

Methods of Signing Git Commits on MacOS

Last updated March 13, 2024

This Gist explains how to sign commits using gpg in a step-by-step fashion. Previously, krypt.co was heavily mentioned, but I've only recently learned they were acquired by Akamai and no longer update their previous free products. Those mentions have been removed.

Additionally, 1Password now supports signing Git commits with SSH keys and makes it pretty easy-plus you can easily configure Git Tower to use it for both signing and ssh.

For using a GUI-based GIT tool such as Tower or Github Desktop, follow the steps here for signing your commits with GPG.

Copied from http://code.lancepollard.com/complete-list-of-html-meta-tags/

Basic HTML Meta Tags

<meta charset='UTF-8'>
<meta name='keywords' content='your, tags'>
<meta name='description' content='150 words'>
<meta name='subject' content='your website's subject'>
<meta name='copyright' content='company name'>

Useful regex during manuscript cleanup

Copy-paste to split book into separate chapter files (also see split.sh)
Add non-breaking space in range of numbers
Fix inline spans broken by a space after a word before the closing *
Remove image width and height inherited from images in docx
Wrap all images in an Electric Book figure blockquote
Simplify indentation in lists by reducing space after list marker to one space
[Remove non-kramdown markdown ^ around superscripts after numbers](#remove-non-kramdown-markdown--around-superscripts-a

Testing the matrix.org client-server API

Matrix is:

an open standard for decentralised communication, providing simple HTTP APIs and open source reference implementations for securely distributing and persisting JSON over an open federation of servers.

It's pretty fantastic, if you think on the massive problem of fragmentation all across the web. They've created an easy to use API, and you can do a kludgy test using curl from the terminal (*nix, mac, win). See: http://matrix.org/docs/howtos/client-server.html

It's pretty straightforward to do a quick test. I have an account at https://matrix.org / https://vector.im, so I used that to get a token.

	#!/usr/bin/env bash
	# Time-stamp: <2017-10-23 12:14:47 kmodi>

	# Hugo build script.. for hugo version build after switching to Go dep.
	# (v0.31-DEV+)

	# Usage: ./hugo_mybuild.sh # Installs using origin/master
	# ./hugo_mybuild.sh --rev v0.30.2

	#${GOPATH}/src/github.com/gohugoio/hugo/README.md


	get_latest_release() {
	curl --silent "https://api.github.com/repos/$1/releases/latest" \| # Get latest release from GitHub api
	grep '"tag_name":' \| # Get tag line
	sed -E 's/."([^"]+)"./\1/' # Pluck JSON value
	}

	# Usage
	# $ get_latest_release "creationix/nvm"
	# v0.31.4

	Thanks for stopping by.

	This code has been moved to https://github.com/kaushalmodi/hugo-debugprint as a Hugo theme component.