monthly_report.mdwn 5.3 KB
Newer Older
1
2
[[!meta title="Monthly reports"]]

3
[[!map pages="blueprint/monthly_report/**" show="title"]]
sajolida's avatar
sajolida committed
4

5
6
This page could be a good place to gather HOWTO, tips, template, etc.
for the monthly reports.
sajolida's avatar
sajolida committed
7

8
9
[[!toc]]

sajolida's avatar
sajolida committed
10
11
12
13
<a id="coordinators"></a>

Coordinators for the next reports
=================================
14
15
16
17
18

The month in the list corresponds to the month to be reported about. For
example, the report about April in the list will be written at the
beginning of May.

127.0.0.1's avatar
127.0.0.1 committed
19
  - January: u
127.0.0.1's avatar
127.0.0.1 committed
20
21
22
23
24
25
  - February:emmapeel
  - March: intrigeri
  - April: spriver
  - May: u
  - June: intrigeri
  - July: spriver
127.0.0.1's avatar
127.0.0.1 committed
26
27
  - August: sajolida
  - September: emmapeel
28

sajolida's avatar
sajolida committed
29
30
31
Checklist
=========

32
- Check [[reports written for sponsors|contribute/reports]]
sajolida's avatar
sajolida committed
33
- Check the archives of:
sajolida's avatar
sajolida committed
34
35
36
  - <https://mailman.boum.org/pipermail/tails-dev/>
  - <https://mailman.boum.org/pipermail/tails-ux/>
  - <https://mailman.boum.org/pipermail/tails-project/>
127.0.0.1's avatar
127.0.0.1 committed
37
  - <https://tails.boum.org/contribute/meetings/>
sajolida's avatar
sajolida committed
38
- Explore the Git history:
39
40
  - `git log --patch --since="January 1" --until="February 1"`
  - XXX: Find a command to output the diff instead of the log here.
sajolida's avatar
sajolida committed
41
- Redmine view of closed issues:
42
  - <https://labs.riseup.net/code/projects/tails/issues?query_id=212>
sajolida's avatar
sajolida committed
43
44
45
46

Publishing
==========

sajolida's avatar
sajolida committed
47
48
49
50
51
52
53
- If you don't have the commit bit on our main repo, notify
  tails-project@boum.org when you think that the report is ready for
  publication.

- If you have the commit bit on our main repo, you can do the
  publication:

54
  - Set the `meta date=` directive to today's date.
sajolida's avatar
sajolida committed
55
  - Move report to `news/report_YEAR_MO.mdwn`.
56
  - Commit and push.
sajolida's avatar
sajolida committed
57
58
59
60
  - Tweet about the report:
       - "In MONTH we worked on [...] and more: https://tails.boum.org/news/report_YEAR_MO."
       - If you don't have access to our Twitter account send you text
         for the tweet along with your merge request for the report.
61
62
63
64
  - Email the link to the report (and if you have time+energy, the
    full text after adjusting its formatting for email):

          To: tails-project@boum.org
65
          Cc: tor-reports@lists.torproject.org
66
67
68
          Subject: Tails report for XXXXXXXX YYYY
          Reply-to: tails-project@boum.org

sajolida's avatar
sajolida committed
69
  - Make sure that we already have a volunteer for next month, or
intrigeri's avatar
intrigeri committed
70
    otherwise raise the issue on <tails-project@boum.org> and update the
sajolida's avatar
sajolida committed
71
    [[list of volunteers|monthly_report#coordinators]].
sajolida's avatar
sajolida committed
72

sajolida's avatar
sajolida committed
73
74
75
Template
========

sajolida's avatar
sajolida committed
76
    \[[!meta title="Tails report for MONTH, YEAR"]]
77
    \[[!meta date="DATE"]]
sajolida's avatar
sajolida committed
78

79
    \[[!toc]]
sajolida's avatar
sajolida committed
80

sajolida's avatar
sajolida committed
81
82
    Releases
    ========
sajolida's avatar
sajolida committed
83

sajolida's avatar
sajolida committed
84
    * \[[Tails VERSION was released on MONTH DAY|news/version_VERSION]] ([major|minor] release).
sajolida's avatar
sajolida committed
85

sajolida's avatar
sajolida committed
86
    * Tails VERSION+1 is \[[scheduled for MONTH DAY|contribute/calendar]].
sajolida's avatar
sajolida committed
87

sajolida's avatar
sajolida committed
88
    The following changes were introduced in Tails VERSION:
sajolida's avatar
sajolida committed
89

sajolida's avatar
sajolida committed
90
    XXX: Copy the "Changes" section of the release notes, and compact a bit:
91
92
93
94
95

    * Remove lines about software upgrade (that's not Tails itself).
    * Remove screenshots.
    * Remove "New features" and "Upgrades and changes" headlines.
    * Remove line about Changelog.
sajolida's avatar
sajolida committed
96

sajolida's avatar
sajolida committed
97
98
    Code
    ====
sajolida's avatar
sajolida committed
99

sajolida's avatar
sajolida committed
100
101
    XXX: List important code work that is not covered already by the Release
         section (for example, the changes being worked on for the next version).
sajolida's avatar
sajolida committed
102

sajolida's avatar
sajolida committed
103
104
    Documentation and website
    =========================
sajolida's avatar
sajolida committed
105

106
107
108
109
    XXX: Explore the Git history:

             git log --patch --since='1 October' --until='1 November' origin/master -- "*.*m*"

sajolida's avatar
sajolida committed
110
111
    User experience
    ===============
sajolida's avatar
sajolida committed
112

113
114
    XXX: Check the archives of tails-ux: https://mailman.boum.org/pipermail/tails-ux/

sajolida's avatar
sajolida committed
115
116
    Infrastructure
    ==============
sajolida's avatar
sajolida committed
117

sajolida's avatar
sajolida committed
118
    XXX: Count the number of tests in /features at the beginning of next month
sajolida's avatar
sajolida committed
119

sajolida's avatar
sajolida committed
120
121
             git checkout `git rev-list -n 1 --before="June 1" origin/devel`
             git grep --extended-regexp '^\s*Scenario:' -- features/*.feature | wc -l
sajolida's avatar
sajolida committed
122

sajolida's avatar
sajolida committed
123
    XXX: Report only if more scenarios have been written and add the diff from the previous month, for example:
sajolida's avatar
sajolida committed
124

sajolida's avatar
sajolida committed
125
           - Our test suite covers SCENARIOS scenarios, DIFF more that in May.
sajolida's avatar
sajolida committed
126

sajolida's avatar
sajolida committed
127
128
    Funding
    =======
sajolida's avatar
sajolida committed
129

sajolida's avatar
sajolida committed
130
    XXX: The fundraising team should look at the fundraising Git.
sajolida's avatar
sajolida committed
131

sajolida's avatar
sajolida committed
132
           git log --patch --since='1 December' --until='1 January' origin/master
sajolida's avatar
sajolida committed
133

sajolida's avatar
sajolida committed
134
    XXX: The fundraising and accounting teams should look at the archives of <tails-fundraising@boum.org> and <tails-accounting@boum.org>.
127.0.0.1's avatar
127.0.0.1 committed
135

sajolida's avatar
sajolida committed
136
137
    Outreach
    ========
sajolida's avatar
sajolida committed
138

sajolida's avatar
sajolida committed
139
140
    Past events
    -----------
sajolida's avatar
sajolida committed
141

sajolida's avatar
sajolida committed
142
143
    Upcoming events
    ---------------
sajolida's avatar
sajolida committed
144

sajolida's avatar
sajolida committed
145
146
    On-going discussions
    ====================
sajolida's avatar
sajolida committed
147

sajolida's avatar
sajolida committed
148
    XXX: Link to the thread on <https://mailman.boum.org/pipermail/tails-XXX/>.
sajolida's avatar
sajolida committed
149

sajolida's avatar
sajolida committed
150
151
    Press and testimonials
    ======================
sajolida's avatar
sajolida committed
152

sajolida's avatar
sajolida committed
153
154
155
    XXX: Copy content from press/media_appearances_2016.mdwn
         This page is continuously updated by tails-press@boum.org, so if
         it's empty there might be nothing special to report.
156

sajolida's avatar
sajolida committed
157
158
    Translation
    ===========
sajolida's avatar
sajolida committed
159

sajolida's avatar
sajolida committed
160
    XXX: Add the output of `contribute/l10n_tricks/language_statistics.sh`
sajolida's avatar
sajolida committed
161
162
163
164
165
    XXX: Add the output of (adjust month!):

        git checkout $(git rev-list -n 1 --before="September 1" origin/master) && \
        git submodule update --init && \
        ./wiki/src/contribute/l10n_tricks/language_statistics.sh
sajolida's avatar
sajolida committed
166

sajolida's avatar
sajolida committed
167
168
    Metrics
    =======
sajolida's avatar
sajolida committed
169

sajolida's avatar
sajolida committed
170
171
172
    * Tails has been started more than BOOTS/MONTH times this month. This makes BOOTS/DAY boots a day on average.
    * SIGS downloads of the OpenPGP signature of Tails ISO from our website.
    * WHISPERBACK bug reports were received through WhisperBack.
127.0.0.1's avatar
127.0.0.1 committed
173

sajolida's avatar
sajolida committed
174
    XXX: Ask tails@boum.org for these numbers.