aboutsummaryrefslogtreecommitdiff
blob: fd474808bdd110d8bc7b1aad8eed626252bc32ba (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
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
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/" lang="en">

  <title>Contributing to the Scientific Project</title>

  <author title="Author">
    <mail link="bicatali@gentoo.org">Sébastien Fabbro</mail>
    <!-- others add your name here -->
  </author>

  <abstract>
    This document provides information on how one can get involved and 
    help out with the Gentoo Scientific Project
  </abstract>

  <!-- The content of this document is licensed under the CC-BY-SA license -->
  <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
  <license/>

  <version>0.1</version>
  <date>2009-01-21</date>

  <chapter>
    <title>Overview</title>
    <section>
      <body>
        <p>
          This document aims to provide information on how one can get
          involved and help out with the Gentoo Scientific Project.
	  Scientific packages are very diverse and many of us want our
          pet application in the main tree for easy installation. Due to
          the small size of our team, we can not implement all of
          them, so we really appreciate any contribution.
        </p>
	<p>
	  There are few obvious areas where one can help as we
	  describe below. The Scientific Project tends to set strong
	  requirements on testing, especially on core packages.
	  Comments, thoughts, and feedback is greatly welcomed!
	</p>
      </body>
    </section>
  </chapter>

  <chapter>
    <title>Bugs</title>
    <section>
      <title>Reporting</title>
      <body>
        <p>
          All good software has bugs. They are too many combinations of
          compilers, USE flags and versions to test them all. So if
          you find the time to report them, we would love to hear
          about it. We have the standard bugzilla system for
          this. Don't be afraid of all these fields to fill in, it's
          not that bad!
        </p>
      </body>
    </section>
    <section>
      <title>Resolving</title>
      <body>
        <p>
	  The Scientific Team in Gentoo has always had a high number of
	  bugs. Fortunately, many of them are new packages. Any help in resolving
	  issues, improving submitted ebuilds is greatly appreciated.
        </p>
        <p>
	  <uri link="http://tinyurl.com/2qxmvu">Bugs for the Scientific Team.</uri>
	  <uri link="http://tinyurl.com/2nm6ag">Bugs for the Biology Team.</uri>
	  <uri link="http://tinyurl.com/368f2d">Bugs for the Chemistry Team.</uri>
	  <uri link="http://tinyurl.com/2lknlo">Bugs for the Electronics Team.</uri>
	  <uri link="http://tinyurl.com/2pcntk">Bugs for the Mathematics Team.</uri>
	  <uri link="http://tinyurl.com/3789aa">Bugs for the Physics Team.</uri>
        </p>
      </body>
    </section>
  </chapter>

  <chapter>
    <title>Writing ebuilds</title>
    <section>
      <body>
        <p>
	  You don't see your application in the main tree or in the
	  overlays and you don't want to wait for someone else to
	  create the ebuilds? The most obvious solution is to develop
	  your own ebuilds. If you do so, it's always nice to share
	  them. You can post them to our bugzilla system and then one
	  of our devs will comment out. The <uri link="http://overlays.gentoo.org/proj/sunrise">sunrise
	  overlay</uri> allows you more directly to commit your
	  ebuilds if you don't want to wait for science access.
	</p>
      </body>
    </section>
  </chapter>

  <chapter>
    <title>Communication</title>
    <section>
      <title>Mailing List</title>
      <body>
        <p>
          Join our
          <uri link="http://www.gentoo.org/main/en/lists.xml"> gentoo-science mailing list
          </uri> and asking/answering questions. 
        </p>
      </body>
    </section>
    <section>
      <title>IRC</title>
      <body>
        <p>
          Meet some of us in #gentoo-science. It is a fairly quiet
          channel, but slowly growing and we are responsive. We can
          answer your questions, help you developing your ebuilds,
          share ideas, etc...
        </p>
      </body>
    </section>
      <title>Direct emails</title>
      <body>
        <p>
	  If you feel your questions are more private and don't need
	  to be known from the rest of the world, you can always
	  directly send an email to our developers
	  listed <uri link="http://www.gentoo.org/main/en/proj/science/index.xml">here</uri>
	  and the listed sub-projects. If you want to mail all of us, send a mail to the herd.
        </p>
      </body>
  </chapter>

  <chapter>
    <title>Writing Documentation</title>
      <body>
	<section>
          <p>
	    You may not be interested in fixing ebuilds and testing
	    packages, but want to share your knowledge about some
	    software, configuration or tips and tricks. The best way to
	    do this is to write some documentation. You can even write
	    official Gentoo documentation such as our
	    <uri link="http://www.gentoo.org/main/en/proj/science/blas-lapack.xml">blas/lapack
	      guide</uri>.
	  </p>
	</section>
      </body>
  </chapter>

  <chapter>
    <title>Seriously getting involved</title>
    <section>
      <body>
        <p>
          If you would like to join our team of volunteers and become
          an official Gentoo Developer, show activity in anywhere you
          can: bugzilla, overlays, mailing lists, irc, forums,...
	  Please refer to
	  <uri link="http://www.gentoo.org/proj/en/devrel/handbook/handbook.xml?part=1&amp;chap=2">
	  Becoming a Developer</uri> in the
	  <uri link="http://www.gentoo.org/proj/en/devrel/handbook/handbook.xml">
	  Gentoo Developer Handbook</uri>.
        </p>
	<p> 
	  Benefits are huge :-) :
          <dl>
            <dd>
              <ul>
		<li>Receive a warm welcome from us</li>
		<li>Impress your geek friends</li>
		<!--<li>Loose your social life, but</li>-->
		<li>Get a free beer first time we meet in person!</li>
              </ul>
            </dd>
          </dl>	  
	</p>

      </body>
    </section>
  </chapter>
</guide>