Difference between revisions of "Commit Cruncher"
Line 20: | Line 20: | ||
As scribe, take meeting minutes in a text editor, such as gedit, nano, or if you're a strange, strange person, vim. | As scribe, take meeting minutes in a text editor, such as gedit, nano, or if you're a strange, strange person, vim. | ||
− | Anytime you get to a commitment, type it as follows: | + | '''New Commits''' |
+ | |||
+ | Anytime you get to a new commitment, type it as follows: | ||
# Name will do blah. | # Name will do blah. | ||
Line 30: | Line 32: | ||
* Stand alone on a line. For complex commits, break them into single bits. | * Stand alone on a line. For complex commits, break them into single bits. | ||
− | Older commits | + | '''Older commits''' |
Each time a commit appears in minutes, it should have an additional hash mark appended to it, such as | Each time a commit appears in minutes, it should have an additional hash mark appended to it, such as | ||
Revision as of 16:42, 6 May 2010
The Commit Cruncher is a geeky little tool conceived by Tony and created by Ryan.
This is a first pass at creating a user guide for it.
It's a script that will alter a text file in a way that hopefully makes commits easier to track, leading to better minutes, better follow through and less work for the scribe.
How to get it
The script is installed on claws, and can be run from any terminal there, but it also can be downloaded for use on non-network machines, such as personal lappies.
How to turn on repo thing. Go to System > Administration > blah > blah
do this thing.
Open a terminal and type:
Specific code to type (can't remember)
How to use it
While scribing
As scribe, take meeting minutes in a text editor, such as gedit, nano, or if you're a strange, strange person, vim.
New Commits
Anytime you get to a new commitment, type it as follows:
# Name will do blah.
The commit should:
- Begin with a hash mark
- Be a simple declarative sentence
- Have its first word be the name of the person who is committing to do something.
- Stand alone on a line. For complex commits, break them into single bits.
Older commits Each time a commit appears in minutes, it should have an additional hash mark appended to it, such as
### Steve will do this thing CO
Many hash marks indicate a stalled, old thing.
When a commit has been completed, end the line with "done."
## Steve will do X Done ### Alix wil do Y done.
Notice periods and caps do not matter.
After the meeting, save the text file as minutes.txt (or something like this)
Running the script
To execute the script, open a terminal and navigate to the directory where the minutes.txt file is stored.
Then type:
commit-crunch minutes.txt
Example
Here is example text of minutes to be crunched:
Before Blah
After Blah