monthly_report.mdwn 5.15 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
20

sajolida's avatar
sajolida committed
21
22
23
Checklist
=========

24
- Check [[reports written for sponsors|contribute/reports]]
sajolida's avatar
sajolida committed
25
- Check the archives of:
sajolida's avatar
sajolida committed
26
27
28
  - <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
29
  - <https://tails.boum.org/contribute/meetings/>
sajolida's avatar
sajolida committed
30
- Explore the Git history:
31
32
  - `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
33
- Redmine view of closed issues:
34
  - <https://labs.riseup.net/code/projects/tails/issues?query_id=212>
sajolida's avatar
sajolida committed
35
36
37
38

Publishing
==========

sajolida's avatar
sajolida committed
39
40
41
42
43
44
45
- 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:

46
  - Set the `meta date=` directive to today's date.
sajolida's avatar
sajolida committed
47
  - Move report to `news/report_YEAR_MO.mdwn`.
48
  - Commit and push.
sajolida's avatar
sajolida committed
49
50
51
52
  - 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.
53
54
55
56
57
58
59
60
  - 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
          Cc: tor-reports@lists.torproject.org
          Subject: Tails report for XXXXXXXX YYYY
          Reply-to: tails-project@boum.org

sajolida's avatar
sajolida committed
61
62
63
  - Make sure that we already have a volunteer for next month, or
    otherwise raise the issue on tails-project@boum.org and update the
    [[list of volunteers|monthly_report#coordinators]].
sajolida's avatar
sajolida committed
64

sajolida's avatar
sajolida committed
65
66
67
Template
========

sajolida's avatar
sajolida committed
68
    \[[!meta title="Tails report for MONTH, YEAR"]]
69
    \[[!meta date="DATE"]]
sajolida's avatar
sajolida committed
70

71
    \[[!toc]]
sajolida's avatar
sajolida committed
72

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

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

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

sajolida's avatar
sajolida committed
80
    The following changes were introduced in Tails VERSION:
sajolida's avatar
sajolida committed
81

sajolida's avatar
sajolida committed
82
    XXX: Copy the "Changes" section of the release notes, and compact a bit:
83
84
85
86
87

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

sajolida's avatar
sajolida committed
89
90
    Code
    ====
sajolida's avatar
sajolida committed
91

sajolida's avatar
sajolida committed
92
93
    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
94

sajolida's avatar
sajolida committed
95
96
    Documentation and website
    =========================
sajolida's avatar
sajolida committed
97

98
99
100
101
    XXX: Explore the Git history:

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

sajolida's avatar
sajolida committed
102
103
    User experience
    ===============
sajolida's avatar
sajolida committed
104

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

sajolida's avatar
sajolida committed
107
108
    Infrastructure
    ==============
sajolida's avatar
sajolida committed
109

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

sajolida's avatar
sajolida committed
112
113
             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
114

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

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

sajolida's avatar
sajolida committed
119
120
    Funding
    =======
sajolida's avatar
sajolida committed
121

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

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

sajolida's avatar
sajolida committed
126
    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
127

sajolida's avatar
sajolida committed
128
129
    Outreach
    ========
sajolida's avatar
sajolida committed
130

sajolida's avatar
sajolida committed
131
132
    Past events
    -----------
sajolida's avatar
sajolida committed
133

sajolida's avatar
sajolida committed
134
135
    Upcoming events
    ---------------
sajolida's avatar
sajolida committed
136

sajolida's avatar
sajolida committed
137
138
    On-going discussions
    ====================
sajolida's avatar
sajolida committed
139

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

sajolida's avatar
sajolida committed
142
143
    Press and testimonials
    ======================
sajolida's avatar
sajolida committed
144

sajolida's avatar
sajolida committed
145
146
147
    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.
148

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

sajolida's avatar
sajolida committed
152
    XXX: Add the output of `contribute/l10n_tricks/language_statistics.sh`
sajolida's avatar
sajolida committed
153
154
155
156
157
    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
158

sajolida's avatar
sajolida committed
159
160
    Metrics
    =======
sajolida's avatar
sajolida committed
161

sajolida's avatar
sajolida committed
162
163
164
    * 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
165

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