Differences between revisions 18 and 19
Revision 18 as of 2011-12-04 18:53:33
Size: 4586
Editor: ?David Prévot
Comment: TINP
Revision 19 as of 2011-12-08 18:15:26
Size: 4807
Comment: added link to it translation + minor fixes to anchors and links
Deletions are marked like this. Additions are marked like this.
Line 2: Line 2:
||<tablestyle="width: 100%;" style="border: 0px hidden">~-[[DebianWiki/EditorGuide#translation|Translation(s)]]: [[es/ProjectNews/Guidelines|Español]]-~||<style="text-align: right;border: 0px hidden"> (!) [[/Discussion|Discussion]]|| ||<tablestyle="width: 100%;" style="border: 0px hidden">~-[[DebianWiki/EditorGuide#translation|Translation(s)]]: English - [[es/ProjectNews/Guidelines|Español]]- [[it/ProjectNews/Guidelines|Italiano]] -~||<style="text-align: right;border: 0px hidden"> (!) [[/Discussion|Discussion]]||
Line 4: Line 4:
(Draft) Style Guidelines for ProjectNews (Draft) Style Guidelines for [[ProjectNews|Debian Project News]]
Line 10: Line 10:
When writing for the ProjectNews you represent the Debian Project to the When writing for the [[ProjectNews|Debian Project News]] you represent the Debian Project to the
Line 15: Line 15:
To be more exact, ProjectNews should follow the spirit of the
[[http://www.debian.org/social_contract|social contract]]; ProjectNews
To be more exact, the [[ProjectNews|Debian Project News]] should follow the spirit of the
[[http://www.debian.org/social_contract|social contract]]; [[ProjectNews|Debian Project News]]
Line 21: Line 21:
<<Anchor(Audience)>>
Line 23: Line 24:
The target audience of the ProjectNews are average users, which might The target audience of the [[ProjectNews|Debian Project News]] are average users, which might
Line 25: Line 26:
ProjectNews should be understandable by these kind of users. [[ProjectNews|Debian Project News]] should be understandable by these kind of users.
Line 27: Line 28:
Often ProjectNews will only be able to point to a specific discussion Often [[ProjectNews|Debian Project News]] will only be able to point to a specific discussion
Line 29: Line 30:
an article in ProjectNews should allow the average user to determine an article in [[ProjectNews|Debian Project News]] should allow the average user to determine
Line 36: Line 37:
See the section in [[ProjectNews/HowToContribute#head-d596c19c65607346179676c678512a58fedc5a00|HowToContribute]] See the section in [[ProjectNews/HowToContribute#Contents|HowToContribute]]
Line 42: Line 43:
Ideally an article suitable for the ProjectNews should be one Ideally an article suitable for the [[ProjectNews|Debian Project News]] should be one
Line 51: Line 52:
[[ProjectNews/Guidelines#head-5589fa41502202a37ba81e3fe47f6dc813380736|audience section]]
ProjectNews should be understandable by average users. For the time being,
[[#Audience|audience section]] the
[[ProjectNews|Debian Project News]] should be understandable by average users. For the time being,
Line 76: Line 77:
Additionally (and if the length restrictions described further below Additionally (and if the length restrictions described previously

Translation(s): English - Español- Italiano

(!) ?Discussion


(Draft) Style Guidelines for Debian Project News

General

When writing for the Debian Project News you represent the Debian Project to the entire world. So please keep in mind that when adding articles, our readers expect a high level of quality, as they are accustomed from everything carrying the name "Debian".

To be more exact, the Debian Project News should follow the spirit of the social contract; Debian Project News articles should be unbiased, objective and truthful. For example, this means that when writing about an ongoing discussion, both points of views should be reported.

Audience

The target audience of the Debian Project News are average users, which might only have a general overview about the project and technical aspects. Debian Project News should be understandable by these kind of users.

Often Debian Project News will only be able to point to a specific discussion without having the space to write a complete summary. At the very least an article in Debian Project News should allow the average user to determine whether or not it is useful to follow the link to read more about the topic.

Content

See the section in HowToContribute for now.

Length

Ideally an article suitable for the Debian Project News should be one at most two paragraph long. They should just be a short summary of the topic with possible links (e.g. mailing list archive) for further reading for interested people.

Style

As outlined in the audience section the Debian Project News should be understandable by average users. For the time being, since there are no translations sent out, we should keep in mind that many of our readers may not be native English speakers. So currently a simple, and concise English style is preferred.

So far British English is preferred over American English, as is done with the Debian web page (where news will end up, too).

The date format follows the MHRA Style Guide, as described at http://lists.debian.org/debian-publicity/2008/05/msg00050.html, as per example, 12 April 2008.

Style guidelines for different kinds of situations

Different situations may require different styles when reporting about them. Here are some ideas:

Reporting ongoing discussions

When writing an article about an ongoing discussion keep in mind when the next issue will be released! Perhaps the discussion will have ended by then? We should point to the exact place where the discussion is taking place. That is don't mention just the mailing list, or that the discussion is currently in progress, but link to the precise email that started the discussion in our mail archive.

Additionally (and if the length restrictions described previously allow it), the major arguments of each party in the discussion should be summarized as well.

Reporting finished discussions

When a discussion has already finished by the time the next issue is sent out, it is more important to report the conclusion. So you may omit the main arguments (which where requested when reporting about ongoing discussions).

However if the discussion was quite long, it would be preferable to mention (and link to) the major arguments, too, so readers don't need to crawl through the whole discussion themselves.

Reporting Interviews

When reporting about an interview with relevance to Debian (e.g. Release Master interviewed by LWN; HP representative interviewed and mentioning Debian) it should not only be noted that an interview took place and where to find it, but also try to summarize the key points of the interview.

Reporting upcoming events

It must be clear to our readers what they can expect when visiting the Debian Project related event. Will there be a booth or only Debian related talks? How many and what audience they are targeting? Is there an entry fee for the event? Where can Debian be found on that event? Is there anything one can do to volunteer or help out at the event?


CategoryProjectNews