/automark

auto-generate blog post from coding history

Primary LanguageC#

automark

automark enables reviewing, sharing, and summarizing programming tasks by automatically generating markdown from your coding history.

The auto-generated markdown or rendered html can help you:

  1. Hand-off tasks to other teammates,
  2. Recover from an interruption, or
  3. Document how to perform a similar task in the future.

It is available as a Visual Studio extension in the Visual Studio gallery.

Motivation

Developers commonly blog about how-to tasks and development experiences in programming. But not everyone blogs, and the ones that do often spend several hours recalling, formatting, and crafting a blog post. The goal of automark is to

  1. reduce the friction associated with blogging,
  2. make it more habitual, and
  3. allow developers to focus on the narrative of a blog post.

Example output created with automark:

DiffHighlight

See the full example of a blog post created with automark.

Features

Automark is designed to support episodic review, a cognitive process for walking through and reasoning about recent code changes, mistakes, and events.

To support this, automark can

  • read a autogit repository and generates a series of time-ordered code changes.
  • support for rendering and displaying unified diffs.
  • include additional references, such as visited Stack Overflow questions or official documentation pages used.
  • generate markdown or html

Using automark

To use automark, first ensure that autogit has been installed first.

Menu

To generate a markdown representation of the recent coding task, select Tools -> automark -> Generate Markdown. This will generate a markdown file stored in $SolutionFolder\.HistoryData\md\Timestamp.md and then open it in an markdown editor. For windows, I recommend using Markdown Pro. From here, the markdown can be annotated and further later generated as a html.

Markdown

To generate a rendered html representation, including diff highlighting, select Tools -> automark -> Generate Html.

Html

Installing automark

  • Download .vsix and double click to install, or search for "automark" in Online Gallery in "Visual Studio's Tools > Extensions and Updates" tool menu.

  • To install from source, first install the Visual Studio SDK 2012 in order to build project. Then install the resulting .vsix file.

Future Features