gitstats/TODO.txt

- development statistics generator for git
	- should be as versatile as statcvs / statsvn

- language?
	- perl or python?

- make git data collection part separate so that portage to other DVCS's is easier
	- DataCollector

- make output thingies modular as well (HTML first, plain text later etc)
	- ReportCreator

[Information]
- git-log
- git-ls-files
	- Current list of files
- git-log --stat or --shortstat - N files changed, N insertions, N deletions
- git-log --name-status - svn-like list of modifications for each commit
- git-rev-list --all
	- first and last commit
- git-show-ref --tags
- git-log |git-shortlog -s
	- author: number of commits
- git-what-changed

[Stats]
- General
	- Report Period (git-log)
	- DONE Total Files (git-ls-files)
	- WIP Total LOC?
	- DONE Total Commits
	- DONE Authors

- Authors
	- List of authors
	- (T): author, commits (%), LOC?, first commit, last commit
	- (T): Developer of the Month: month, author, commits, LOC?

- (G) Lines of Code: x = date, y = lines

- Tags
	- (T): Name, Date, LOC?, Developers

- Author page for each author
	- Name, mail
	- Total commits (%)
	- LOC (%)
	- Last commit: date
	- First commit: date
	- Activity by Clock Time
		- (G) Hour of Day
		- (G) Day of Week
	- (T) Activity in Directories: Directory, Changes, LOC, LOC/change
	- (Most Recent Commits?)

[Stats in StatSVN]
- General
	- Report Period (first/last date of commits)
	- Total files?
	- Total LOC?
	- Developers

- Main stats
	- Lines of Code: x = date, y = lines, releases/tags as vertical lines
	- Table: Top 10 Authors: author, LOC (%)
	- Table: Repository tags: name, date, lines, LOC Churn, Developers
	- Tree: Directories: dir (N files, N lines)

- Developers
	- Number of developers
	- Table: author, changes (%), LOC (%), LOC/change
	- Graph: Lines of Code: x = date, y = lines, colored lines for each author
	- Table: Developer of the Month: month, author, lines
	- Graph: Developer Activity
	- Graph: Author Activity (bar for each author, showing modifying/adding percentages) (could be table)
	- Graphs: Activity by Clock Time
		- Hour of Day
		- Day of Week

- Commit logs
- Lines of Code (same as main graph)

- File Statistics
	- Graph: File Sizes and File Counts: x = date, y = files
	- Graph: Average File Size (x = date, y = LOC/file)
	- Table: File Types
	- Table: Largest Files
	- Table: Files With Most Revisions

- Directory sizes
- "Repo heatmap"?
- LOC and Churn

[Graphics]
- Use gnuplot, graphviz etc ?

[Usage]
- $ statgit [-o html] /path/to/git /output/dir

[name]
- statgit or gitstats (no google hits for either)

[Misc]
- use sortable.js ?