'Re: [Quanta] Quanta Documentation: English'

[prev in list] [next in list] [prev in thread] [next in thread] 

List:       quanta
Subject:    Re: [Quanta] Quanta Documentation: English
From:       Paul Lemmons <paul () lemmons ! name>
Date:       2007-02-02 18:17:06
Message-ID: 45C38022.9040704 () lemmons ! name
[Download RAW message or body]

[Attachment #2 (text/html)]

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
  <meta content="text/html;charset=ISO-8859-1" http-equiv="Content-Type">
</head>
<body bgcolor="#ffffff" text="#000000">
We developers should never write end user documentation. Even when the
audience is other developers. We all suffer from the "It is intuitively
obvious by simple observation" syndrome.&nbsp; There is a completely
different skill set used in writing documentation. Documentation should
be written by those than have the skill to do it. Our role in
documentation is to simply complain about it :)<br>
<br>
-------- Original Message&nbsp; --------<br>
Subject: Re:[Quanta] Quanta Documentation: English<br>
From: Andras Mantia <a class="moz-txt-link-rfc2396E" \
                href="mailto:amantia@kde.org">&lt;amantia@kde.org&gt;</a><br>
To: Quanta users list <a class="moz-txt-link-rfc2396E" \
                href="mailto:quanta@mail.kde.org">&lt;quanta@mail.kde.org&gt;</a><br>
Date: 02/02/2007 08:50 AM<br>
<blockquote cite="mid200702021750.13226.amantia@kde.org" type="cite">
  <pre wrap="">On Saturday 27 January 2007, B&oslash;rge Holen wrote:
  </pre>
  <blockquote type="cite">
    <pre wrap="">The docs really need a workover. Last time I checked, they said
nothing of use...
    </pre>
  </blockquote>
  <pre wrap=""><!---->

I just wrote the same to the devel list. They rather describe what a 
function does, not how you can use it. Well, many parts were written by 
a developer, especially the description of newer features.

Andras
  </pre>
  <pre wrap="">
<hr size="4" width="90%">
_______________________________________________
Quanta mailing list
<a class="moz-txt-link-abbreviated" \
href="mailto:Quanta@mail.kde.org">Quanta@mail.kde.org</a> <a \
class="moz-txt-link-freetext" \
href="https://mail.kde.org/mailman/listinfo/quanta">https://mail.kde.org/mailman/listinfo/quanta</a>
  </pre>
</blockquote>
<br>
</body>
</html>

_______________________________________________
Quanta mailing list
Quanta@mail.kde.org
https://mail.kde.org/mailman/listinfo/quanta

[prev in list] [next in list] [prev in thread] [next in thread] 