This file is indexed.

/usr/share/doc/libvirt-doc/contribute.html is in libvirt-doc 4.0.0-1ubuntu8.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  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
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml">
  <!--
        This file is autogenerated from contribute.html.in
        Do not edit this file. Changes will be lost.
      -->
  <!--
        This page was generated at Mon Nov 13 21:46:25 UTC 2017.
      -->
  <head>
    <meta charset="UTF-8"/>
    <meta name="viewport" content="width=device-width, initial-scale=1"/>
    <link rel="stylesheet" type="text/css" href="main.css"/>
    <link rel="apple-touch-icon" sizes="180x180" href="/apple-touch-icon.png"/>
    <link rel="icon" type="image/png" sizes="32x32" href="/favicon-32x32.png"/>
    <link rel="icon" type="image/png" sizes="16x16" href="/favicon-16x16.png"/>
    <link rel="manifest" href="/manifest.json"/>
    <meta name="theme-color" content="#ffffff"/>
    <title>libvirt: Contributing to libvirt</title>
    <meta name="description" content="libvirt, virtualization, virtualization API"/>
    <script type="text/javascript">
      <!--
          
      function init() {
      window.addEventListener('scroll', function(e){
              var distanceY = window.pageYOffset || document.documentElement.scrollTop,
              shrinkOn = 94
              home = document.getElementById("home");
              links = document.getElementById("jumplinks");
              search = document.getElementById("search");
              body = document.getElementById("body");
              if (distanceY > shrinkOn) {
                  if (home.className != "navhide") {
                      body.className = "navhide"
                      home.className = "navhide"
                      links.className = "navhide"
                      search.className = "navhide"
                  }
              } else {
                  if (home.className == "navhide") {
                      body.className = ""
                      home.className = ""
                      links.className = ""
                      search.className = ""
                  }
              }
      });
      }
      window.onload = init();
           
          -->
    </script>
  </head>
  <body>
    <div id="body">
      <div id="content">
        <h1>Contributing to libvirt</h1>
        <p>
      This page provides guidance on how to contribute to the
      libvirt project
    </p>
        <ul>
          <li>
            <a href="#skills">Contributions required</a>
          </li>
          <li>
            <a href="#comms">Communication</a>
            <ul>
              <li>
                <a href="#email">Mailing lists</a>
              </li>
              <li>
                <a href="#irc">Instant messaging / chat</a>
              </li>
            </ul>
          </li>
          <li>
            <a href="#outreach">Student / outreach coding programs</a>
          </li>
        </ul>
        <h2>
          <a id="skills">Contributions required</a>
          <a class="headerlink" href="#skills" title="Permalink to this headline"></a>
        </h2>
        <p>
      The libvirt project is always looking for new contributors to
      participate in ongoing activities. While code development is a
      major part of the project, assistance is needed in many other
      areas including documentation writing, bug triage, testing,
      application integration, website / wiki content management,
      translation, branding, social media and more. The only
      requirement is an interest in virtualization and desire to
      help.
    </p>
        <p>
      The following is a non-exhaustive list of areas in which
      people can contribute to libvirt. If you have ideas for
      other contributions feel free to follow them.
    </p>
        <ul>
          <li><strong>Software development</strong>. The core library / daemon (and
        thus the bulk of coding) is written in C, but there are
        language bindings written in Python, Perl, Java, Ruby,
        Php, OCaml and Go. There are also higher level wrappers
        mapping libvirt into other object frameworks, such GLib,
        CIM and SNMP. For those interested in working on the core parts of
        libvirt, the <a href="hacking.html">contributor guidelines</a> are
        mandatory reading</li>
          <li><strong>Translation</strong>. All the libvirt modules aim to support
        translations where appropriate. All translation is
        handling outside of the normal libvirt review process,
        using the <a href="http://fedora.zanata.org">Fedora
        instance</a> of the Zanata tool. Thus people wishing
        to contribute to translation should join the Fedora
        translation team</li>
          <li><strong>Documentation</strong>. There are docbook guides on various
        aspects of libvirt, particularly application development
        guides for the C library and Python, and a virsh command
        reference. There is thus scope for work by people who are
        familiar with using or developing against libvirt, to
        write further content for these guides. There is also a
        need for people to review existing content for copy editing
        and identifying gaps in the docs</li>
          <li><strong>Website / wiki curation</strong>. The bulk of the website is
        maintained in the primary GIT repository, while the wiki
        site uses mediawiki. In both cases there is a need for
        people to both write new content and curate existing
        content to identify outdated information, improve its
        organization and target gaps.</li>
          <li><strong>Testing</strong>. There are a number of tests suites that can run
        automated tests against libvirt. The coverage of the tests
        is never complete, so there is a need for people to create
        new test suites and / or provide environments to actually
        run the tests in a variety of deployment scenarios.</li>
          <li><strong>Code analysis</strong>. The libvirt project has access to the coverity
        tool to run static analysis against the codebase, however,
        there are other types of code analysis that can be useful.
        In particular fuzzing of the inputs can be very effective
        at identifying problematic edge cases.</li>
          <li><strong>Security handling</strong>. Downstream (operating system) vendors
        who distribute libvirt may wish to propose a person to
        be part of the security handling team, to get early access
        to information about forthcoming vulnerability fixes.</li>
          <li><strong>Evangalism</strong>. Work done by the project is of no benefit
        unless the (potential) user community knows that it
        exists. Thus it is critically important to the health
        and future growth of the project, that there are a people
        who evangalise the work created by the project. This can
        take many forms, writing blog posts (about usage of features,
        personal user experiances, areas for future work, and more),
        syndicating docs and blogs via social media, giving user
        group and/or conference talks about libvirt.</li>
          <li><strong>User assistance</strong>. Since documentation
        is never perfect, there are inevitably cases where users
        will struggle to attain a deployment goal they have, or
        run into trouble with managing an existing deployment.
        While some users may be able to contact a software vendor
        to obtain support, it is common to rely on community help
        forums such as <a href="contact.html#email">libvirt users
          mailing list</a>, or sites such as
        <a href="http://stackoverflow.com/questions/tagged/libvirt">stackoverflow.</a>
        People who are familiar with libvirt and have ability &amp;
        desire to help other users are encouraged to participate in
        these help forums.</li>
        </ul>
        <h2>
          <a id="comms">Communication</a>
          <a class="headerlink" href="#comms" title="Permalink to this headline"></a>
        </h2>
        <p>
      For full details on contacting other project contributors
      read the <a href="contact.html">contact</a> page. There
      are two main channels that libvirt uses for communication
      between contributors:
    </p>
        <h3>
          <a id="email">Mailing lists</a>
          <a class="headerlink" href="#email" title="Permalink to this headline"></a>
        </h3>
        <p>
      The project has a number of
      <a href="contact.html#email">mailing lists</a> for
      general communication between contributors.
      In general any design discussions and review
      of contributions will take place on the mailing
      lists, so it is important for all contributors
      to follow the traffic.
    </p>
        <h3>
          <a id="irc">Instant messaging / chat</a>
          <a class="headerlink" href="#irc" title="Permalink to this headline"></a>
        </h3>
        <p>
      Contributors to libvirt are encouraged to join the
      <a href="contact.html#irc">IRC channel</a> used by
      the project, where they can have live conversations
      with others members.
    </p>
        <h2>
          <a id="outreach">Student / outreach coding programs</a>
          <a class="headerlink" href="#outreach" title="Permalink to this headline"></a>
        </h2>
        <p>
      Since 2016, the libvirt project directly participates as an
      organization in the <a href="http://wiki.libvirt.org/page/Google_Summer_of_Code_Ideas">Google Summer of Code program</a>. Prior to
      this the project had a number of students in the program
      via a joint application with the QEMU project. People are
      encouraged to look at both the libvirt and QEMU programs
      to identify potentially interesting projects to work on.
    </p>
      </div>
    </div>
    <div id="nav">
      <div id="home">
        <a href="index.html">Home</a>
      </div>
      <div id="jumplinks">
        <ul>
          <li>
            <a href="downloads.html">Download</a>
          </li>
          <li>
            <a href="contribute.html">Contribute</a>
          </li>
          <li>
            <a href="docs.html">Docs</a>
          </li>
        </ul>
      </div>
      <div id="search">
        <form action="search.php" enctype="application/x-www-form-urlencoded" method="get">
          <div>
            <input name="query" type="text" size="12" value=""/>
            <input name="submit" type="submit" value="Go"/>
          </div>
        </form>
      </div>
    </div>
    <div id="footer">
      <div id="contact">
        <h3>Contact</h3>
        <ul>
          <li>
            <a href="contact.html#email">email</a>
          </li>
          <li>
            <a href="contact.html#irc">irc</a>
          </li>
        </ul>
      </div>
      <div id="community">
        <h3>Community</h3>
        <ul>
          <li>
            <a href="https://twitter.com/hashtag/libvirt">twitter</a>
          </li>
          <li>
            <a href="https://plus.google.com/communities/109522598353007505282">google+</a>
          </li>
          <li>
            <a href="http://stackoverflow.com/questions/tagged/libvirt">stackoverflow</a>
          </li>
          <li>
            <a href="http://serverfault.com/questions/tagged/libvirt">serverfault</a>
          </li>
        </ul>
      </div>
      <div id="conduct">
            Participants in the libvirt project agree to abide by <a href="governance.html#codeofconduct">the project code of conduct</a></div>
      <br class="clear"/>
    </div>
  </body>
</html>