/[gentoo]/xml/htdocs/proj/en/glep/glep-0030.html
Gentoo

Contents of /xml/htdocs/proj/en/glep/glep-0030.html

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.6 - (show annotations) (download) (as text)
Thu Jan 25 03:25:53 2007 UTC (7 years, 10 months ago) by antarus
Branch: MAIN
Changes since 1.5: +3 -3 lines
File MIME type: text/html
Fix headers in all current gleps

1 <?xml version="1.0" encoding="utf-8" ?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4 <!--
5 This HTML is auto-generated. DO NOT EDIT THIS FILE! If you are writing a new
6 PEP, see http://www.python.org/peps/pep-0001.html for instructions and links
7 to templates. DO NOT USE THIS HTML FILE AS YOUR TEMPLATE!
8 -->
9 <head>
10 <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
11 <meta name="generator" content="Docutils 0.4: http://docutils.sourceforge.net/" />
12 <title>GLEP 30 -- "Planet Gentoo" web log aggregator</title>
13 <style type="text/css">
14
15 /*
16 :Author: David Goodger
17 :Contact: goodger@users.sourceforge.net
18 :date: $Date: 2006/10/10 20:25:14 $
19 :version: $Revision: 1.5 $
20 :copyright: This stylesheet has been placed in the public domain.
21
22 Default cascading style sheet for the PEP HTML output of Docutils.
23 */
24
25 .first {
26 margin-top: 0 }
27
28 .last {
29 margin-bottom: 0 }
30
31 .navigation {
32 width: 100% ;
33 background: #cc99ff ;
34 margin-top: 0px ;
35 margin-bottom: 0px }
36
37 .navigation .navicon {
38 width: 150px ;
39 height: 35px }
40
41 .navigation .textlinks {
42 padding-left: 1em ;
43 text-align: left }
44
45 .navigation td, .navigation th {
46 padding-left: 0em ;
47 padding-right: 0em ;
48 vertical-align: middle }
49
50 .rfc2822 {
51 margin-top: 0.5em ;
52 margin-left: 0.5em ;
53 margin-right: 0.5em ;
54 margin-bottom: 0em }
55
56 .rfc2822 td {
57 text-align: left }
58
59 .rfc2822 th.field-name {
60 text-align: right ;
61 font-family: sans-serif ;
62 padding-right: 0.5em ;
63 font-weight: bold ;
64 margin-bottom: 0em }
65
66 a.toc-backref {
67 text-decoration: none ;
68 color: black }
69
70 body {
71 margin: 0px ;
72 margin-bottom: 1em ;
73 padding: 0px }
74
75 dd {
76 margin-bottom: 0.5em }
77
78 div.section {
79 margin-left: 1em ;
80 margin-right: 1em ;
81 margin-bottom: 1.5em }
82
83 div.section div.section {
84 margin-left: 0em ;
85 margin-right: 0em ;
86 margin-top: 1.5em }
87
88 div.abstract {
89 margin: 2em 5em }
90
91 div.abstract p.topic-title {
92 font-weight: bold ;
93 text-align: center }
94
95 div.attention, div.caution, div.danger, div.error, div.hint,
96 div.important, div.note, div.tip, div.warning {
97 margin: 2em ;
98 border: medium outset ;
99 padding: 1em }
100
101 div.attention p.admonition-title, div.caution p.admonition-title,
102 div.danger p.admonition-title, div.error p.admonition-title,
103 div.warning p.admonition-title {
104 color: red ;
105 font-weight: bold ;
106 font-family: sans-serif }
107
108 div.hint p.admonition-title, div.important p.admonition-title,
109 div.note p.admonition-title, div.tip p.admonition-title {
110 font-weight: bold ;
111 font-family: sans-serif }
112
113 div.figure {
114 margin-left: 2em }
115
116 div.footer, div.header {
117 font-size: smaller }
118
119 div.footer {
120 margin-left: 1em ;
121 margin-right: 1em }
122
123 div.system-messages {
124 margin: 5em }
125
126 div.system-messages h1 {
127 color: red }
128
129 div.system-message {
130 border: medium outset ;
131 padding: 1em }
132
133 div.system-message p.system-message-title {
134 color: red ;
135 font-weight: bold }
136
137 div.topic {
138 margin: 2em }
139
140 h1 {
141 font-family: sans-serif ;
142 font-size: large }
143
144 h2 {
145 font-family: sans-serif ;
146 font-size: medium }
147
148 h3 {
149 font-family: sans-serif ;
150 font-size: small }
151
152 h4 {
153 font-family: sans-serif ;
154 font-style: italic ;
155 font-size: small }
156
157 h5 {
158 font-family: sans-serif;
159 font-size: x-small }
160
161 h6 {
162 font-family: sans-serif;
163 font-style: italic ;
164 font-size: x-small }
165
166 .section hr {
167 width: 75% }
168
169 ol.simple, ul.simple {
170 margin-bottom: 1em }
171
172 ol.arabic {
173 list-style: decimal }
174
175 ol.loweralpha {
176 list-style: lower-alpha }
177
178 ol.upperalpha {
179 list-style: upper-alpha }
180
181 ol.lowerroman {
182 list-style: lower-roman }
183
184 ol.upperroman {
185 list-style: upper-roman }
186
187 p.caption {
188 font-style: italic }
189
190 p.credits {
191 font-style: italic ;
192 font-size: smaller }
193
194 p.label {
195 white-space: nowrap }
196
197 p.topic-title {
198 font-family: sans-serif ;
199 font-weight: bold }
200
201 pre.line-block {
202 font-family: serif ;
203 font-size: 100% }
204
205 pre.literal-block, pre.doctest-block {
206 margin-left: 2em ;
207 margin-right: 2em ;
208 background-color: #eeeeee }
209
210 span.classifier {
211 font-family: sans-serif ;
212 font-style: oblique }
213
214 span.classifier-delimiter {
215 font-family: sans-serif ;
216 font-weight: bold }
217
218 span.interpreted {
219 font-family: sans-serif }
220
221 span.option-argument {
222 font-style: italic }
223
224 span.pre {
225 white-space: pre }
226
227 span.problematic {
228 color: red }
229
230 table {
231 margin-top: 0.5em ;
232 margin-bottom: 0.5em }
233
234 td, th {
235 padding-left: 0.5em ;
236 padding-right: 0.5em ;
237 vertical-align: top }
238
239 td.num {
240 text-align: right }
241
242 th.field-name {
243 font-weight: bold ;
244 text-align: left ;
245 white-space: nowrap }
246
247 h1 tt, h2 tt, h3 tt, h4 tt, h5 tt, h6 tt {
248 font-size: 100% }
249
250 tt {
251 background-color: #eeeeee }
252
253 ul.auto-toc {
254 list-style-type: none }
255
256 </style>
257 </head>
258 <body bgcolor="white">
259 <table class="navigation" cellpadding="0" cellspacing="0"
260 width="100%" border="0">
261 <tr><td class="navicon" width="150" height="35">
262 <a href="http://www.gentoo.org/" title="Gentoo Linux Home Page">
263 <img src="http://www.gentoo.org/images/gentoo-new.gif" alt="[Gentoo]"
264 border="0" width="150" height="35" /></a></td>
265 <td class="textlinks" align="left">
266 [<b><a href="http://www.gentoo.org/">Gentoo Linux Home</a></b>]
267 [<b><a href="http://www.gentoo.org/proj/en/glep/">GLEP Index</a></b>]
268 [<b><a href="http://www.gentoo.org/proj/en/glep/glep-0030.txt">GLEP Source</a></b>]
269 </td></tr></table>
270 <table class="rfc2822 docutils field-list" frame="void" rules="none">
271 <col class="field-name" />
272 <col class="field-body" />
273 <tbody valign="top">
274 <tr class="field"><th class="field-name">GLEP:</th><td class="field-body">30</td>
275 </tr>
276 <tr class="field"><th class="field-name">Title:</th><td class="field-body">&quot;Planet Gentoo&quot; web log aggregator</td>
277 </tr>
278 <tr class="field"><th class="field-name">Version:</th><td class="field-body">1.4</td>
279 </tr>
280 <tr class="field"><th class="field-name">Last-Modified:</th><td class="field-body"><a class="reference" href="http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/proj/en/glep/glep-0030.txt?cvsroot=gentoo">2005/03/11 14:18:17</a></td>
281 </tr>
282 <tr class="field"><th class="field-name">Author:</th><td class="field-body">Daniel Drake &lt;dsd&#32;&#97;t&#32;gentoo.org&gt;</td>
283 </tr>
284 <tr class="field"><th class="field-name">Status:</th><td class="field-body">Final</td>
285 </tr>
286 <tr class="field"><th class="field-name">Type:</th><td class="field-body">Standards Track</td>
287 </tr>
288 <tr class="field"><th class="field-name">Content-Type:</th><td class="field-body"><a class="reference" href="glep-0002.html">text/x-rst</a></td>
289 </tr>
290 <tr class="field"><th class="field-name">Created:</th><td class="field-body">24-Oct-2004</td>
291 </tr>
292 <tr class="field"><th class="field-name">Post-History:</th><td class="field-body">25-Oct-2004, 10-Nov-2004, 11-Mar-2005</td>
293 </tr>
294 </tbody>
295 </table>
296 <hr />
297 <div class="contents topic">
298 <p class="topic-title first"><a id="contents" name="contents">Contents</a></p>
299 <ul class="simple">
300 <li><a class="reference" href="#status" id="id21" name="id21">Status</a></li>
301 <li><a class="reference" href="#credits" id="id22" name="id22">Credits</a></li>
302 <li><a class="reference" href="#abstract" id="id23" name="id23">Abstract</a></li>
303 <li><a class="reference" href="#motivation" id="id24" name="id24">Motivation</a></li>
304 <li><a class="reference" href="#specification" id="id25" name="id25">Specification</a></li>
305 <li><a class="reference" href="#rationale" id="id26" name="id26">Rationale</a></li>
306 <li><a class="reference" href="#backwards-compatibility" id="id27" name="id27">Backwards Compatibility</a></li>
307 <li><a class="reference" href="#reference-implementation" id="id28" name="id28">Reference Implementation</a></li>
308 <li><a class="reference" href="#references" id="id29" name="id29">References</a></li>
309 <li><a class="reference" href="#copyright" id="id30" name="id30">Copyright</a></li>
310 </ul>
311 </div>
312 <div class="section">
313 <h1><a class="toc-backref" href="#id21" id="status" name="status">Status</a></h1>
314 <p>The new <a class="reference" href="http://planet.gentoo.org/">Planet Gentoo</a> <a class="footnote-reference" href="#id1" id="id2" name="id2">[1]</a> came online 10-Mar-2005, so this GLEP is now Final.</p>
315 </div>
316 <div class="section">
317 <h1><a class="toc-backref" href="#id22" id="credits" name="credits">Credits</a></h1>
318 <ul class="simple">
319 <li><a class="reference" href="mailto:stuart&#64;gentoo.org">Stuart Herbert</a> <a class="footnote-reference" href="#id3" id="id4" name="id4">[2]</a> for the original idea</li>
320 <li><a class="reference" href="mailto:alexander&#64;gentoo.org">Alexander Plank</a> <a class="footnote-reference" href="#id5" id="id6" name="id6">[3]</a> who also has put effort into promoting this</li>
321 </ul>
322 </div>
323 <div class="section">
324 <h1><a class="toc-backref" href="#id23" id="abstract" name="abstract">Abstract</a></h1>
325 <p>This GLEP proposes the creation of &quot;Planet Gentoo&quot;, a new section of the
326 gentoo.org website. It would aggregate weblogs (commonly known as &quot;blogs&quot;)
327 written by contributing Gentoo developers onto this single page, available to
328 the public. I will refer to this new website section as &quot;the planet&quot; in this
329 GLEP.
330 We would also provide an installation of a weblog engine for developers that
331 do not currently have their own weblog.</p>
332 </div>
333 <div class="section">
334 <h1><a class="toc-backref" href="#id24" id="motivation" name="motivation">Motivation</a></h1>
335 <p>I'm trying to reduce the gap between the Gentoo user and development
336 communities.</p>
337 <p>Many large open source projects and software distributors have their own
338 Planet where contributors weblogs are aggregated. See the <a class="reference" href="http://www.planetplanet.org">Planetplanet</a> <a class="footnote-reference" href="#id8" id="id9" name="id9">[4]</a>
339 homepage for a complete listing. These other aggregations appear to be
340 successful and bring their relevant communities together.</p>
341 <p>These aggregations are often quite interesting to read, since they contain a
342 variation of topics, not all of which are related to the project.</p>
343 <p>The planet would add another method of user interaction with developers, as
344 most weblogs allow readers to post comments.</p>
345 <p>Readers would get more interested in the Gentoo project, and would get a feel
346 for the personalities of the contributing developers. Although I am not
347 suggesting this should be used as an announcement tool, developers could also
348 use this to get general messages over to the user community.</p>
349 <p>This would also benefit our development, as developers would also be able to
350 keep track of what other developers are working on and promote more
351 collaboration amongst each other.</p>
352 </div>
353 <div class="section">
354 <h1><a class="toc-backref" href="#id25" id="specification" name="specification">Specification</a></h1>
355 <p>The proposed design is an installation of <a class="reference" href="http://www.planetplanet.org">Planetplanet</a> <a class="footnote-reference" href="#id8" id="id10" name="id10">[4]</a> at a part of the
356 gentoo.org infrastructure, e.g. <a class="reference" href="http://planet.gentoo.org">http://planet.gentoo.org</a></p>
357 <p>We would also provide an installation of <a class="reference" href="http://packages.gentoo.org/search/?sstring=wordpress">Wordpress</a> <a class="footnote-reference" href="#id12" id="id13" name="id13">[5]</a> or a similar weblogging
358 engine, for developers that do not have their own weblog or would wish to
359 move their log to an official Gentoo hosted website. This could be provided
360 at (e.g.) <a class="reference" href="http://weblogs.gentoo.org">http://weblogs.gentoo.org</a></p>
361 </div>
362 <div class="section">
363 <h1><a class="toc-backref" href="#id26" id="rationale" name="rationale">Rationale</a></h1>
364 <p><a class="reference" href="http://www.planetplanet.org">Planetplanet</a> <a class="footnote-reference" href="#id8" id="id11" name="id11">[4]</a> is simply a weblog aggregator written in python. It is
365 executed as a cronjob and fetches content from all the weblogs it has been
366 asked to, postprocesses and aggregates them into a single html file (based on
367 a template), and outputs that html content to an area provided by a webserver.
368 This should allow for ease of integration with any existing infrastructure.</p>
369 <p>Planetplanet is configurable through a single configuration file, which lists
370 the log feed URL, real name and user name for each contributing developer.</p>
371 <p><a class="reference" href="http://packages.gentoo.org/search/?sstring=wordpress">Wordpress</a> <a class="footnote-reference" href="#id12" id="id14" name="id14">[5]</a> is a weblogging engine written in PHP. It relies on MySQL for
372 the data store. After the initial setup, all configuration is done through a
373 web-based interface.</p>
374 <p>A group of people would be assigned the responsibility/CVS access to maintain
375 these two services. I would suggest the existing infrastructure team to have
376 this responsibility. If required, I will assist with the initial
377 configuration.</p>
378 <p>The planetplanet installation would fetch and aggregate developers weblogs
379 only, we would not accept non-developer logs.</p>
380 <p>Developers do not have to host their weblogs with us, practically all blogging
381 packages provide an XML feed (typically RSS) which planetplanet will happily
382 fetch and process. Other feed formats are also accepted, examine the
383 planetplanet documentation for more info.
384 In the event of a contributing Gentoo developer leaving the project, their log
385 would be removed from the aggregation. If their log was hosted by ourselves,
386 it would be closed. For this reason, some developers may choose to host their
387 log elsewhere - this is not a problem and is left to the decision of the
388 individual developers.</p>
389 <p>It is true that the addition of the planet to our website collection would add
390 yet another source of Gentoo information to our collection; our users and
391 developers are already overwhelmed with IRC, mailing lists, forums, and the
392 central website. In contrast, a lot of information is currently replicated
393 over those mediums, but the planet would provide a taste of something new.
394 Developers can choose their own topics and are free to write about things that
395 perhaps would not fit into our existing communication mediums. Additionally,
396 the planet will attempt to bring some existing content together by linking to
397 recent commits, bug lists, and dev.gentoo.org webspace for each contributing
398 developer.</p>
399 <p>It has been suggested that the activity of the planet may be an issue:
400 although a lot of activity would make the planet very successful, it may look
401 bad on us as a whole if the planet is inactive.</p>
402 <p><a class="reference" href="mailto:alexander&#64;gentoo.org">Alexander Plank</a> <a class="footnote-reference" href="#id5" id="id7" name="id7">[3]</a> started a <a class="reference" href="http://thread.gmane.org/gmane.linux.gentoo.devel/20480">gentoo-dev discussion</a> <a class="footnote-reference" href="#id15" id="id16" name="id16">[6]</a> back in August regarding
403 this exact idea. Alexander set up a <a class="reference" href="http://penguincluster.com/cgi-bin/wiki.pl/BlogInterest">Planet Gentoo mini-survey</a> <a class="footnote-reference" href="#id17" id="id18" name="id18">[7]</a> to see which
404 developers have weblogs or would be interested in obtaining one to be
405 aggregated on the planet. At the time of writing, the survey yielded a list
406 of 21 interested developers.</p>
407 <p>Looking at the other planets available, a contributor count like this would be
408 more than enough to keep the planet active and interesting. Through my
409 experiments of finding developers existing weblogs through google and
410 aggregating them on my local Planetplanet installation, I have come to the
411 conclusion that just a small quantity of active weblogs is enough to keep the
412 planet going strongly.</p>
413 <p>I also note that the list of 21 interested developers was built up over a
414 short space of time, and it was only mentioned once in a rather large thread
415 on the gentoo-dev mailing list. I predict that given more publicity amongst
416 the developers, this idea would be even more popular. I also predict that if
417 such a planet were to go live, other developers would be motivated to join in,
418 and new developers joining the project would be keen on contributing.</p>
419 <p>The success of the planet will be evaluated by examining the number of hits to
420 the planet. 3 months after launch, one weeks worth of logs will be recorded,
421 and hits will be counted. If the hit count for that week is below 1000, the
422 planet will be deemed as not having met its target, and appropriate action can
423 be taken if the planet appears to be harming our image.</p>
424 </div>
425 <div class="section">
426 <h1><a class="toc-backref" href="#id27" id="backwards-compatibility" name="backwards-compatibility">Backwards Compatibility</a></h1>
427 <p>No issues.</p>
428 </div>
429 <div class="section">
430 <h1><a class="toc-backref" href="#id28" id="reference-implementation" name="reference-implementation">Reference Implementation</a></h1>
431 <p>See <a class="reference" href="http://bugs.gentoo.org/63160">Bug 63160</a> <a class="footnote-reference" href="#id19" id="id20" name="id20">[8]</a> for a template file mimicking the current gentoo.org design
432 plus a sample config file.</p>
433 </div>
434 <div class="section">
435 <h1><a class="toc-backref" href="#id29" id="references" name="references">References</a></h1>
436 <table class="docutils footnote" frame="void" id="id1" rules="none">
437 <colgroup><col class="label" /><col /></colgroup>
438 <tbody valign="top">
439 <tr><td class="label"><a class="fn-backref" href="#id2" name="id1">[1]</a></td><td><a class="reference" href="http://planet.gentoo.org/">http://planet.gentoo.org/</a></td></tr>
440 </tbody>
441 </table>
442 <table class="docutils footnote" frame="void" id="id3" rules="none">
443 <colgroup><col class="label" /><col /></colgroup>
444 <tbody valign="top">
445 <tr><td class="label"><a class="fn-backref" href="#id4" name="id3">[2]</a></td><td><a class="reference" href="mailto:stuart&#64;gentoo.org">mailto:stuart&#64;gentoo.org</a></td></tr>
446 </tbody>
447 </table>
448 <table class="docutils footnote" frame="void" id="id5" rules="none">
449 <colgroup><col class="label" /><col /></colgroup>
450 <tbody valign="top">
451 <tr><td class="label"><a name="id5">[3]</a></td><td><em>(<a class="fn-backref" href="#id6">1</a>, <a class="fn-backref" href="#id7">2</a>)</em> <a class="reference" href="mailto:alexander&#64;gentoo.org">mailto:alexander&#64;gentoo.org</a></td></tr>
452 </tbody>
453 </table>
454 <table class="docutils footnote" frame="void" id="id8" rules="none">
455 <colgroup><col class="label" /><col /></colgroup>
456 <tbody valign="top">
457 <tr><td class="label"><a name="id8">[4]</a></td><td><em>(<a class="fn-backref" href="#id9">1</a>, <a class="fn-backref" href="#id10">2</a>, <a class="fn-backref" href="#id11">3</a>)</em> <a class="reference" href="http://www.planetplanet.org">http://www.planetplanet.org</a></td></tr>
458 </tbody>
459 </table>
460 <table class="docutils footnote" frame="void" id="id12" rules="none">
461 <colgroup><col class="label" /><col /></colgroup>
462 <tbody valign="top">
463 <tr><td class="label"><a name="id12">[5]</a></td><td><em>(<a class="fn-backref" href="#id13">1</a>, <a class="fn-backref" href="#id14">2</a>)</em> <a class="reference" href="http://packages.gentoo.org/search/?sstring=wordpress">http://packages.gentoo.org/search/?sstring=wordpress</a></td></tr>
464 </tbody>
465 </table>
466 <table class="docutils footnote" frame="void" id="id15" rules="none">
467 <colgroup><col class="label" /><col /></colgroup>
468 <tbody valign="top">
469 <tr><td class="label"><a class="fn-backref" href="#id16" name="id15">[6]</a></td><td><a class="reference" href="http://thread.gmane.org/gmane.linux.gentoo.devel/20480">http://thread.gmane.org/gmane.linux.gentoo.devel/20480</a></td></tr>
470 </tbody>
471 </table>
472 <table class="docutils footnote" frame="void" id="id17" rules="none">
473 <colgroup><col class="label" /><col /></colgroup>
474 <tbody valign="top">
475 <tr><td class="label"><a class="fn-backref" href="#id18" name="id17">[7]</a></td><td><a class="reference" href="http://penguincluster.com/cgi-bin/wiki.pl/BlogInterest">http://penguincluster.com/cgi-bin/wiki.pl/BlogInterest</a></td></tr>
476 </tbody>
477 </table>
478 <table class="docutils footnote" frame="void" id="id19" rules="none">
479 <colgroup><col class="label" /><col /></colgroup>
480 <tbody valign="top">
481 <tr><td class="label"><a class="fn-backref" href="#id20" name="id19">[8]</a></td><td><a class="reference" href="http://bugs.gentoo.org/63160">http://bugs.gentoo.org/63160</a></td></tr>
482 </tbody>
483 </table>
484 </div>
485 <div class="section">
486 <h1><a class="toc-backref" href="#id30" id="copyright" name="copyright">Copyright</a></h1>
487 <p>This document has been placed in the public domain.</p>
488 </div>
489
490 </div>
491 <div class="footer">
492 <hr class="footer" />
493 <a class="reference" href="glep-0030.txt">View document source</a>.
494 Generated on: 2006-10-10 20:23 UTC.
495 Generated by <a class="reference" href="http://docutils.sourceforge.net/">Docutils</a> from <a class="reference" href="http://docutils.sourceforge.net/rst.html">reStructuredText</a> source.
496
497 </div>
498 </body>
499 </html>

  ViewVC Help
Powered by ViewVC 1.1.20