todo: more items.
[gitstats.git] / doc / TODO.txt
blobd8aaa6a153069d9d160f7d1819ff78a8f63930c9
1 []
2 - BUG broken for git repo
3 - Files
4         - (T) File count by date
5 - index: generated in N secs
7 - save gnuplot files in inline code, or in current dir as 
8         - ability to change the gnuplot instructions run-time would be nice, though
9 - style class for images (<div class="graph">)?
10 - better style for images & tables (keep next to each other?)
12 [0.0.1]
13 - copy/link statgit.css to target dir
14 - rename to gitstats ?
16 [Unsorted]
17 - use sortable.js
19 [Information]
20 - git-log
21 - git-ls-files
22         - Current list of files
23 - git-ls-tree -r <revision>
24         - get a list of files in each revision
25 - git-log --stat or --shortstat - N files changed, N insertions, N deletions
26 - git-log --name-status - svn-like list of modifications for each commit
27 - git-rev-list --all
28         - first and last commit
29 - git-show-ref --tags
30         - not all tags are tags on refs?
31 - git-log |git-shortlog -s
32         - author: number of commits
33 - git-what-changed
34 - XXX git-log --pretty=oneline |wc -l != git-rev-list --all |wc -l
35         - git-rev-list HEAD == git-log --pretty=oneline
36 - for rev in $(git-rev-list HEAD); do echo "$rev" $(git-ls-tree -r "$rev" |wc -l); done
37         - number of files in each revision
39 [Stats]
40 - General
41         - Report Period (git-log)
42         - DONE Total Files (git-ls-files)
43         - DONE Total LOC?
44         - DONE Total Commits
45         - DONE Authors
47 - Activity by Time?
48         - (G?) Last 30 days
49         - (G?) Last 12 months
50         - DONE Hour of Day
51         - DONE Day of Week
52                 - Hour of weekday -> 7x25?
53         - DONE Month of Year
54         - DONE Commits by year/month
55         - DONE Commits by year
57 - Authors
58         - List of authors
59                 - show only first 10 and rest on separate page?
60         - DONE (T): author, commits (%), LOC?, first commit, last commit
61         - DONE (T): Developer of the Month: month, author, commits, LOC?
62         - DONE (T): Author of Year
64 - Files
65         - DONE Total Files
66         - DONE Total Lines
67         - DONE Average file size
68         - Average revisions per file
69         - DONE (G) File Count by Date: x = date, y = files
70         - (G) Average file size: x = date, y = lines/file
71         - (T) File Extensions (or mime types from "file"?): extension, files (%), lines (%), lines/file
72                 - extensions: ext -> { files, lines? }
73                         - git-ls-files -> basename -> check ext
74         - (T) Largest Files?
75         - (T) Files With Most Revisions?
77 - (G) Lines of Code: x = date, y = lines
79 - Tags
80         - DONE (T): Name, Date
81         - Lines
82         - Authors (count of people contributing after last version)?
84 - Author page for each author
85         - Name, mail
86         - Total commits (%)
87         - LOC (%)
88         - Last commit: date
89         - First commit: date
90         - Activity by Clock Time
91                 - (G) Hour of Day
92                 - (G) Day of Week
93         - (T) Activity in Directories: Directory, Changes, LOC, LOC/change
94         - (Most Recent Commits?)
96 [Stats in StatSVN]
97 - General
98         - Report Period (first/last date of commits)
99         - Total files?
100         - Total LOC?
101         - Developers
103 - Main stats
104         - Lines of Code: x = date, y = lines, releases/tags as vertical lines
105         - Table: Top 10 Authors: author, LOC (%)
106         - Table: Repository tags: name, date, lines, LOC Churn, Developers
107         - Tree: Directories: dir (N files, N lines)
109 - Developers
110         - Number of developers
111         - Table: author, changes (%), LOC (%), LOC/change
112         - Graph: Lines of Code: x = date, y = lines, colored lines for each author
113         - Table: Developer of the Month: month, author, lines
114         - Graph: Developer Activity
115         - Graph: Author Activity (bar for each author, showing modifying/adding percentages) (could be table)
116         - Graphs: Activity by Clock Time
117                 - Hour of Day
118                 - Day of Week
120 - Commit logs
121 - Lines of Code (same as main graph)
123 - File Statistics
124         - Graph: File Sizes and File Counts: x = date, y = files
125         - Graph: Average File Size (x = date, y = LOC/file)
126         - Table: File Types
127         - Table: Largest Files
128         - Table: Files With Most Revisions
130 - Directory sizes
131 - "Repo heatmap"?
132 - LOC and Churn
134 [Graphics]
135 - Use gnuplot, graphviz etc ?
137 [Usage]
138 - $ statgit [-o html] /path/to/git /output/dir
140 [name]
141 - statgit or gitstats (no google hits for either)
143 [Misc]
144 - use sortable.js ?
145 - could show some statistics from last year, month, etc... pisg-like?
146 - style: tabs at top for different pages