Mailinglist Archive: yast-devel (95 mails)
| < Previous | Next > |
[yast-devel] How to write
- From: Martin Vidner <mvidner@xxxxxxx>
- Date: Mon, 15 Jun 2009 14:37:21 +0200
- Message-id: <20090615123721.GD6072@xxxxxxxxxxxxxxxx>
On Mon, Jun 15, 2009 at 01:19:36PM +0200, josef reidinger wrote:
Josef, you must write better, otherwise people will not listen.
It is hard to read not because the ideas are hard but because
- There are frequent mistakes in English (you know that already).
This is actually enough to make my brain hurt, and I sometimes
skip what you write just because of that.
- The text is not structured. You should
- Use paragraphs, make sentences shorter.
- Capitalize properly (DBus and HTTP).
- Use quotes (...permissions like "Change HTTP server" which ensure...).
Please have in mind that you are asking many people on the list to
read what you write and think about it. So take the time to read it
over yourself and edit it so that the form does not kill the
content.
--
Martin Vidner, YaST developer
http://en.opensuse.org/User:Mvidner
Kuracke oddeleni v restauraci je jako fekalni oddeleni v bazenu
--
To unsubscribe, e-mail: yast-devel+unsubscribe@xxxxxxxxxxxx
For additional commands, e-mail: yast-devel+help@xxxxxxxxxxxx
What about use two tool over permissions? So we provide via dbus atomic
permission to change one enclosed atribute and then have in webyast
client for changing permission which provide agregate permissions and
can change set of atomic permissions like Change http server which
ensure that all atomic permission needed for http server is provided (of
course provide info what atomic permission it is). I think that for
admins is more important what exactly can user change (single values)
then high level abstraction permission which can change more then admin
want.
Josef, you must write better, otherwise people will not listen.
It is hard to read not because the ideas are hard but because
- There are frequent mistakes in English (you know that already).
This is actually enough to make my brain hurt, and I sometimes
skip what you write just because of that.
- The text is not structured. You should
- Use paragraphs, make sentences shorter.
- Capitalize properly (DBus and HTTP).
- Use quotes (...permissions like "Change HTTP server" which ensure...).
Please have in mind that you are asking many people on the list to
read what you write and think about it. So take the time to read it
over yourself and edit it so that the form does not kill the
content.
--
Martin Vidner, YaST developer
http://en.opensuse.org/User:Mvidner
Kuracke oddeleni v restauraci je jako fekalni oddeleni v bazenu
--
To unsubscribe, e-mail: yast-devel+unsubscribe@xxxxxxxxxxxx
For additional commands, e-mail: yast-devel+help@xxxxxxxxxxxx
| < Previous | Next > |