aboutsummaryrefslogtreecommitdiff
path: root/doc/todo/Updated_bug_tracking_example.mdwn
blob: 4fbb064973045d3cd9c98310c649a4480fff3327 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
I've put together an updated bug tracking example.  This example requires some recent
patches of mine.  It requires [[todo/tracking_bugs_with_dependencies]], 
[[todo/Allow_edittemplate_to_set_file_type]] and the second [[patch]] in
[[todo/structured_page_data]] (the data plugin, not the form plugin).

You'll then want to add/replace the following files in the software project example.  The
heading is the name of the file.  I've commented all the directives.  Oh, and I don't
have nice CSS for this yet. I did make sure that if I borrowed
[Trac's](http://trac.edgewall.org/) css then it would display as nicely as theirs - the
html is there if not the CSS.

It might be worth adding some justification of what is going on here.  The datatable
and data directives generate a nice tabular form for the structured data.  The HTML
generated is the same as for Trac, except I've got fewer fields.  Adding more is trivial.

I use data directives rather than links because the data directive allows separating
dependencies from links.  We can specify 'bugs with all dependencies closed' without
being confused by other links on the page.

-- [[Will]]

### templates/bug.mdwn

    \[[!datatable class="bugtable" datalist="""
    [[!data key="Reported by" link=""]]					[[!data key="Owned by" link=""]]
    [[!data key="Depends on"]]
    """]]
    
    ### Description
    
    This is a bug that needs solving.
    
    #### Steps to reproduce:
    
    #### What I expect to happen:
    
    #### What actually happens:
    
    #### What I have tried to narrow it down:
    
### bugs.mdwn

    This is FooBar's bug list. Link bugs to \[[bugs/done]] when done.
    
    \[[!inline pages="bugs and ! bugs" feeds=no postform=yes 
    postformtext="Report a bug:" rootpage="bugs"]]
    
    \[[!edittemplate template="templates/bug" match="bugs/* and !*/Discussion" silent=yes]]
    
    \[[!toggle id="all bugs" text="Show all bugs"]]
    
    \[[!toggle id="open bugs" text="Show open bugs"]]
    
    \[[!toggle id="ready bugs" text="Show ready bugs (open bugs with all dependencies closed)"]]
    
    \[[!toggleable id="ready bugs" text="""
    #### Ready Bugs
    
    Open bugs with all dependencies closed.
    
    [[!inline pages="define(~open, ./bugs/* and !./bugs/done and !link(done) and !*/Discussion)
    and ~open and !data_link(Depends on,~open)" actions=yes archive=yes show=0]]
    """]]
    
    \[[!toggleable id="open bugs" text="""
    #### Open Bugs
    
    [[!inline pages="./bugs/* and !./bugs/done and !link(done) 
    and !*/Discussion" actions=yes archive=yes show=0]]
    """]]
    
    \[[!toggleable id="all bugs" text="""
    #### All Bugs
    
    [[!inline pages="./bugs/* and !./bugs/done and !*/Discussion"
    actions=yes archive=yes show=0]]
    """]]
    
### bugs/needs_more_bugs.mdwn

    \[[!datatable class="bugtable" datalist="""
    [[!data key="Reported by" link="John"]]					[[!data key="Owned by" link="Frank"]]
    [[!data key="Depends on" link="bugs/fails_to_frobnicate"]]
    """]]
    
    ### Description
    
    FooBar does not have enough bugs, which suggests that it's not a real Free
    Software project. Please help create more bugs by adding code to FooBar!
    :-)
    
    #### Steps to reproduce:
    
    Test frobnicate.
    
    #### What I expect to happen:
    
    It should fail.
    
    #### What actually happens:
    
    It works.
    
    #### What I have tried to narrow it down:
    
    I've added some code, but I'm not sure it was the right code.

### bugs/fails_to_frobnicate.mdwn

    \[[!datatable class="bugtable" datalist="""
    [[!data key="Reported by" link="John"]]					[[!data key="Owned by" link="Frank"]]
    [[!data key="Depends on"]]
    """]]
    
    ### Description
    
    FooBar, when used with the `--frob` option, fails to properly frobnicate
    output.
    
    > This is fixed in \[[news/version_1.0]]; marking this bug \[[done]].
    
    #### Steps to reproduce:
    
    Use FooBar with the `--frob` option.
    
    #### What I expect to happen:
    
    Lots of frobnication.
    
    #### What actually happens:
    
    Complete lack of frobnication
    
    #### What I have tried to narrow it down:
    
    Tested on Linux, MacOS and NetBSD.