summaryrefslogtreecommitdiff
blob: c856fe8f6a3a0994a2192aeaff483c2abf5e2e4c (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
<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet href="/xsl/project.xsl" type="text/xsl"?>
<?xml-stylesheet href="/xsl/guide.xsl" type="text/xsl"?>
<!DOCTYPE project SYSTEM "/dtd/project.dtd">

<project>
<name>Web-apps</name>
<longname>Gentoo web applications herd</longname>
<date>2005-06-19</date>

<description>
The web-apps team maintains web applications, an eclass to facilitate writing
ebuilds for these packages, and the webapp-config tool.
</description>

<longdescription>
<p>
The Gentoo webapp team maintains most web applications available via Portage.
In addition, we provide the webapp-config utility that allows users to
install ebuilds into different virtual hosts.
</p>

<p>
We are also responsible for the webapp.eclass that allows to prepare
web applications for installation with webapp-config.
</p>
</longdescription>

<goals>
Our goal is to make Gentoo the best platform for installing and maintaining web
applications. To achieve this goal, we work closely with several other herds
such as Apache and PHP.
</goals>

<!-- developers: add yourself -->
<dev role="Lead">stuart</dev>
<dev role="Lead">rl03</dev>
<dev role="Member" description="webapp-config">wrobel</dev>
<dev>beu</dev>
<dev>chtekk</dev>
<dev>dju</dev>
<dev>jmglov</dev>
<dev>robbat2</dev>
<dev>soulse</dev>
<dev>st_lim</dev>
<dev>trapni</dev>

<!-- links to documentation -->
<resource link="/proj/en/webapps/webapp.eclass.xml">webapp.eclass Documentation</resource>

<!-- Status updates -->
<extrachapter>

<title>Status Updates</title>

<section>
<title>What are Status Updates?</title>
<body>
<p>
We provide regular status updates covering what the webapp team has
accomplished since the previous status update. It is written by one of the team
leaders and contains a quick overview of recent progress.
</p>
</body>
</section>

<section>
<title>Listing</title>
<body>
<p>
The following status updates are available:
</p>
<!--
<ul>
<li><uri link="status/status_20060101.xml">January 1st, 2006</uri></li>
</ul>
-->
</body>
</section>

</extrachapter>

<extrachapter>

<title>Participating</title>

<section>
<title>#gentoo-web on irc.freenode.net</title>
<body>
<p>
The best way to reach us is on <uri link="irc://freenode/gentoo-web">IRC</uri>.
Please feel free to stop by to talk about <c>webapp-config</c> or about web
applications on Gentoo. We also welcome any suggestions for improvement.
</p>
</body>
</section>

<section>
<title>gentoo-web-user@gentoo.org</title>
<body>

<p>
The Gentoo web applications team uses the <mail
link="gentoo-web-users@gentoo.org">gentoo-web-users</mail> mailing list for
discussions related to web applications and <c>webapp-config</c>. This is a
low-volume list.
</p>

<p>
To subscribe to this mailing list, send an empty e-mail to <mail
link="gentoo-web-user-subscribe@gentoo.org">gentoo-web-user-subscribe</mail>.
Once subscribed, you can post by sending an e-mail to <mail
link="gentoo-web-user@gentoo.org">gentoo-web-user@gentoo.org</mail>.
</p>

</body>
</section>

<section>
<title>Web application overlay</title>

<body>

<p>
Web applications in general tend to be a severe security liability. They are
designed to communicate with the outside world and need to deal with a range of
input from the Internet. Since it is often hard for developers to foresee all
types of malicious input, security flaws are being detected rather frequently
in the apps we maintain.
</p>

<p>
To reduce the impact of such incidents while still offering a wide range of
different web applications, we created a Portage <uri
link="http://svn.gnqs.org/projects/gentoo-webapps-overlay">overlay</uri>
that contains ebuilds for applications that we do not want to maintain in the
main tree. Such applications either lack a developer willing to maintain it in
Portage or have not been reviewed for security.
</p>

<warn>
Please remember that the applications available through the overlay might
compromise the security of your server!
</warn>

<p>
The overlay is an ideal playground for new developers wishing to join our
team. Once we see that you are capable of writing ebuilds of reasonable
quality, we can provide you with commit rights to the overlay.
</p>

</body>
</section>

<section>
<title>webapp-config</title>

<body>

<p>
We recently switched from the old bash version of <c>webapp-config</c> to a
version implemented in Python, which is much faster and easier to maintain.

We are currently still debating the roadmap for <c>webapp-config</c>. If you
wish to get an overview of its current state of development, you can visit the
<uri link="http://www.vhost-tools.org">Trac repository</uri>.

If you have any complaints about the software, patches, or suggestions for
improvements, please <uri link="http://www.vhost-tools.org/newticket">submit a
ticket</uri>.
</p>

</body>
</section>

</extrachapter>

<!-- herds -->
<herd name="web-apps" />

</project>