Skip to content
It's like Twitter, for recording things that happen in your project, stored in it's version control repository.
Shell Makefile
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs/adr
src
tests
.adr-dir
.editorconfig
.gitattributes
.travis.yml
GPL.txt
INSTALL.md
LICENSE.txt
Makefile
README.md
approve
new-test
tag-release

README.md

Pottery

It's like Twitter, for recording things that happen in your project, stored in it's version control repository.

Build Status

If you use JetBrains IDEs, you may find the Pottery Idea Plugin more convenient.

Quick Start

Install Pottery.

Use the pottery command to record significant events in your project with short, Twitter-like posts (which we've nicknamed "sherds").

Sherds are stored in a subdirectory of your project as Markdown files. The default directory is docs/project-history, but you can specify a different directory when you initialise the history log.

  1. Create a directory in the root of your project:

     pottery init
    

    This will create a directory named docs/project-history

  2. Post interesting events

     pottery post Alice joined the project
    

    This will create a new Markdown file in a dated subdirectory and file within docs/project-directory. If you don't write any text after the post command, Pottery will open the new file for editing in your editor of choice (as specified by the VISUAL or EDITOR environment variable).

  3. Post more events, when they occur.

     pottery post Bob left the project
     pottery post The company merged with MegaCorp, stopped selling widgets and started promoting doodads.
    

    Over time, you will build a record of the non-technical influences that affected the project over its lifetime.

  4. For further information, use the built in help:

     pottery help
    

See the tests for detailed examples.

You can’t perform that action at this time.