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
|
;;; GNU Guix web site
;;; Initially written by sirgazil who waves all
;;; copyright interest on this file.
(define-module (apps base templates contribute)
#:use-module (apps base templates components)
#:use-module (apps base templates theme)
#:use-module (apps base types)
#:use-module (apps base utils)
#:export (contribute-t))
(define (contribute-t)
"Return the Contribute page in SHTML."
(theme
#:title '("Contribute")
#:description
"Check all the ways you can contribute to make GNU Guix
better, and join the world-wide community of volunteers."
#:keywords
'("GNU" "Linux" "Unix" "Free software" "Libre software"
"Operating system" "GNU Hurd" "GNU Guix package manager"
"Volunteer" "Development" "Translation" "I18N" "L10N"
"Artwork")
#:active-menu-item "About"
#:css (list
(guix-url "static/base/css/page.css")
(guix-url "static/base/css/item-preview.css"))
#:crumbs (list (crumb "Contribute" "./"))
#:content
`(main
(section
(@ (class "page centered-block limit-width"))
(h2 "Contribute")
(p
"GNU Guix is a large project developed
mostly by volunteers from all around the world. You are welcome
to join us in the "
(a (@ (href "https://lists.gnu.org/mailman/listinfo/guix-devel"))
"development mailing list")
" or in the "
(a (@ (href ,(guix-url "contact/irc/"))) "#guix channel")
" in IRC Freenode. Tell us how would you like to help, and we
will do our best to guide you. ")
(p
"We want to provide a warm, friendly, and harassment-free environment,
so that anyone can contribute to the best of their abilities. To this
end our project uses a “Contributor Covenant”, which was adapted from "
(a (@ (href "https://contributor-covenant.org/"))
"https://contributor-covenant.org/")
". You can find the full pledge in the "
(a (@ (href "//git.savannah.gnu.org/cgit/guix.git/tree/CODE-OF-CONDUCT")
(class "mono"))
"CODE-OF-CONDUCT") " file.")
(div
(@ (class "centered-text"))
(div
(@ (class "summary-box"))
(h3 (@ (id "pms")) "Project Management")
(p
"We use "
(a (@ (href "https://savannah.gnu.org/")) "Savannah")
" as the central point for development, maintenance and
distribution of the Guix System Distribution and GNU Guix.")
(p
"The source files for all the components of the project,
including software, web site, documentation, and artwork, are
available in "
(a (@ (href "https://savannah.gnu.org/git/?group=guix"))
"Git repositories")
" at Savannah. ")
(p
,(link-more
#:label "Access Savannah"
#:url "https://savannah.gnu.org/projects/guix")))
(div
(@ (class "summary-box"))
(h3 (@ (id "art")) "Art")
(p
"We are always looking for artists to help us design and
improve user interfaces, and create multimedia material for
documentation, presentations, and promotional items. ")
(p
"The artwork used in the different components of the project
is available in the "
(a (@ (href "//git.savannah.gnu.org/cgit/guix/guix-artwork.git"))
"guix-artwork")
" repository. ")
(p
,(link-more
#:label "Contribute"
#:url "https://lists.gnu.org/mailman/listinfo/guix-devel")))
(div
(@ (class "summary-box"))
(h3 (@ (id "documentation")) "Documentation")
(p
"You can read the "
(a (@ (href ,(guix-url "help/"))) "project documentation")
" already available in the system and in the website, and
help us identify any errors or omissions. Creating new
manuals, tutorials, and blog entries will also help users and
developers discover what we do. ")
(p
"Helping improve the documentation of the "
(a (@ (href ,(guix-url "packages/"))) "packaged software")
" is another way to contribute. ")
(p
,(link-more
#:label "Start writing"
#:url "https://lists.gnu.org/mailman/listinfo/guix-devel")))
(div
(@ (class "summary-box"))
(h3 (@ (id "packages")) "Packages")
(p
"Hundreds of software, documentation, and assets need to be
packaged to make it easier for users to install their
favorite tools with the Guix package manager, and be
productive using the system. ")
(p
"Information on how to add packages to the distribution can
be found "
(a (@ (href ,(manual-url "Packaging-Guidelines.html")))
"in the manual")
". ")
(p
"Check out the "
(a (@ (href ,(guix-url "packages/")))
"package database")
" for a list of available packages, and the "
(a (@ (href "//bugs.gnu.org/guix-patches"))
"patch-tracking database")
" for a list of pending submissions.")
(p
,(link-more
#:label "Send a new package"
#:url "https://lists.gnu.org/mailman/listinfo/guix-patches")))
(div
(@ (class "summary-box"))
(h3 (@ (id "programming")) "Programming")
(p
"Source code is in the "
(a (@ (href "//git.savannah.gnu.org/cgit/guix.git/"))
"main Git repository")
". "
"We use "
(a (@ (href ,(gnu-url "software/guile"))) "GNU Guile")
" as the main programming and extension language for the
components of the system. ")
(p
"You will find it useful to browse the "
(a (@ (href ,(gnu-url "software/guile/manual")))
"Guile manual")
" or other "
(a (@ (href "http://www.schemers.org/Documents/#intro-texts"))
"introductory material about Scheme")
". Also, make sure to read the "
(a (@ (href ,(manual-url "Contributing.html")))
"Contributing")
" section of the manual for more details on the development
setup, as well as the coding and cooperation conventions used
in the project. ")
(p
,(link-more
#:label "Send a patch"
#:url "https://lists.gnu.org/mailman/listinfo/guix-patches")))
(div
(@ (class "summary-box"))
(h3 (@ (id "sysadmin")) "System Administration")
(p
"Our system infrastructure makes it possible for all the
contributors to communicate and collaborate in the project,
and users to be able to download and install packages. Help
us keep the system up and running smoothly. ")
(p
"You can also "
(a (@ (href ,(guix-url "donate/")))
"donate hardware or hosting")
" for our "
(a (@ (href "https://hydra.gnu.org")) "build farm") ". ")
(p
,(link-more
#:label "Contribute"
#:url "https://lists.gnu.org/mailman/listinfo/guix-devel")))
(div
(@ (class "summary-box"))
(h3 (@ (id "testing")) "Test and Bug Reports")
(p
"Install the software and send feedback to the community
about your experience. Help the project reporting bugs.")
(p
"Before reporting a bug, please check whether the bug is
already "
(a (@ (href "https://debbugs.gnu.org/guix"))
"in the bug database")
". See "
(a (@ (href "https://debbugs.gnu.org/Developer.html"))
"the developer information page")
" for more information on how to manipulate bug reports. ")
(p
,(link-more
#:label "Report a bug"
#:url "https://lists.gnu.org/mailman/listinfo/bug-guix")))
(div
(@ (class "summary-box"))
(h3 (@ (id "translation")) "Translation")
(p
"You can help translate the "
(a (@ (href "https://translationproject.org/domain/guix.html"))
"software")
", the "
(a (@ (href "https://translationproject.org/domain/guix-packages.html"))
"package descriptions")
", and the "
(a (@ (href "https://translationproject.org/domain/guix-manual.html"))
"manual")
" into your language. See the "
(a (@ (href "https://translationproject.org/html/translators.html"))
"Translation Project")
" for information on how you can help.")
(p
(a (@ (href ,(guix-url "packages"))) "Software packages")
" provided by the system may have their own translation
tools. Visit their websites and help translate. ")
(p
,(link-more
#:label "Start translating"
#:url "https://translationproject.org/"))))
(h3 (@ (id "resources")) "Other resources for contributors")
(p
"Documents, supporting material of previous talks, and
auxiliary information useful to hackers and maintainers is
available at "
(a (@ (href "//git.savannah.gnu.org/cgit/guix/maintenance.git"))
"git://git.sv.gnu.org/guix/maintenance.git")
".")))))
|
