monthly_report.mdwn 5.93 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
20
21
22
23
24
25
26
27
28
  - January 2017: u
  - February 2017:emmapeel
  - March 2017: intrigeri
  - April 2017: spriver
  - May 2017: u
  - June 2017: intrigeri
  - July 2017: sajolida
  - August 2017: spriver
  - September 2017: emmapeel
  - October 2017:
29
  - November 2017: u
127.0.0.1's avatar
127.0.0.1 committed
30
  - December 2017: muri
sajolida's avatar
sajolida committed
31
  - January 2018: sajolida
127.0.0.1's avatar
127.0.0.1 committed
32
33
  - February 2018:

34

sajolida's avatar
sajolida committed
35
36
37
Checklist
=========

38
- Check [[reports written for sponsors|contribute/reports]]
sajolida's avatar
sajolida committed
39
- Check the archives of:
sajolida's avatar
sajolida committed
40
41
42
  - <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
43
  - <https://tails.boum.org/contribute/meetings/>
sajolida's avatar
sajolida committed
44
- Explore the Git history:
45
46
  - `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
47
- Redmine view of closed issues:
48
  - <https://labs.riseup.net/code/projects/tails/issues?query_id=212>
sajolida's avatar
sajolida committed
49
50
51
52

Publishing
==========

sajolida's avatar
sajolida committed
53
- If you don't have the commit bit on our main repo, notify
intrigeri's avatar
intrigeri committed
54
  <tails-project@boum.org> when you think that the report is ready for
sajolida's avatar
sajolida committed
55
56
57
58
59
  publication.

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

60
  - Set the `meta date=` directive to today's date.
sajolida's avatar
sajolida committed
61
  - Move report to `news/report_YEAR_MO.mdwn`.
62
  - Commit and push.
sajolida's avatar
sajolida committed
63
64
  - Tweet about the report:
       - "In MONTH we worked on [...] and more: https://tails.boum.org/news/report_YEAR_MO."
sajolida's avatar
sajolida committed
65
       - If you don't have access to our Twitter account send your text
sajolida's avatar
sajolida committed
66
         for the tweet along with your merge request for the report.
67
68
69
70
  - 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
intrigeri's avatar
intrigeri committed
71
          Cc: tor-project@lists.torproject.org
72
73
74
          Subject: Tails report for XXXXXXXX YYYY
          Reply-to: tails-project@boum.org

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

sajolida's avatar
sajolida committed
79
80
81
Template
========

sajolida's avatar
sajolida committed
82
    \[[!meta title="Tails report for MONTH, YEAR"]]
intrigeri's avatar
intrigeri committed
83
    \[[!meta date="DATE (eg. Tue Aug 8 12:34:56 2018)"]]
sajolida's avatar
sajolida committed
84

85
    \[[!toc]]
sajolida's avatar
sajolida committed
86

sajolida's avatar
sajolida committed
87
88
    Releases
    ========
sajolida's avatar
sajolida committed
89

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

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

sajolida's avatar
sajolida committed
94
    The following changes were introduced in Tails VERSION:
sajolida's avatar
sajolida committed
95

sajolida's avatar
sajolida committed
96
    XXX: Copy the "Changes" section of the release notes, and compact a bit:
97
98
99
100
101

    * 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
102

sajolida's avatar
sajolida committed
103
104
    Code
    ====
sajolida's avatar
sajolida committed
105

106
107
108
109
    XXX: If you feel like it and developers don't do it themselves,
         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
110

sajolida's avatar
sajolida committed
111
112
    Documentation and website
    =========================
sajolida's avatar
sajolida committed
113

114
115
    XXX: If you feel like it and technical writers don't do it
         themselves, explore the Git history:
116
117
118

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

sajolida's avatar
sajolida committed
119
120
    User experience
    ===============
sajolida's avatar
sajolida committed
121

122
123
124
    XXX: If you feel like it and the UX team does not do it
         themselves, check the archives of tails-ux:
         <https://mailman.boum.org/pipermail/tails-ux/>
125

126
127
128
129
130
131
132
133
134
135
136
    Hot topics on our help desk
    ===========================

    XXX: Ask tails-bugs@boum.org to list hot topics for the last month.

    1.

    1.

    1.

sajolida's avatar
sajolida committed
137
138
    Infrastructure
    ==============
sajolida's avatar
sajolida committed
139

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

sajolida's avatar
sajolida committed
142
143
             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
144

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

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

sajolida's avatar
sajolida committed
149
150
    Funding
    =======
sajolida's avatar
sajolida committed
151

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

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

sajolida's avatar
sajolida committed
156
    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
157

sajolida's avatar
sajolida committed
158
159
    Outreach
    ========
sajolida's avatar
sajolida committed
160

sajolida's avatar
sajolida committed
161
162
    Past events
    -----------
sajolida's avatar
sajolida committed
163

sajolida's avatar
sajolida committed
164
165
    Upcoming events
    ---------------
sajolida's avatar
sajolida committed
166

sajolida's avatar
sajolida committed
167
168
    On-going discussions
    ====================
sajolida's avatar
sajolida committed
169

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

sajolida's avatar
sajolida committed
172
173
    Press and testimonials
    ======================
sajolida's avatar
sajolida committed
174

sajolida's avatar
sajolida committed
175
176
177
    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.
178

sajolida's avatar
sajolida committed
179
180
    Translation
    ===========
sajolida's avatar
sajolida committed
181

sajolida's avatar
sajolida committed
182
    XXX: Add the output of `contribute/l10n_tricks/language_statistics.sh`
sajolida's avatar
sajolida committed
183
184
185
186
187
    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
188

sajolida's avatar
sajolida committed
189
190
    Metrics
    =======
sajolida's avatar
sajolida committed
191

sajolida's avatar
sajolida committed
192
193
194
    * 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
195

196
    \[[How do we know this?|support/faq#boot_statistics]]
197

198
    XXX: Ask <tails@boum.org> for these numbers.