You are not logged in.

#1 2009-02-03 01:34:07

Schneibster
Member
Registered: 2008-12-20
Posts: 32

I edited the NetworkManager page

Could someone please check my style? I tried to fit in with all the stylistic cues I could, but might have missed some, and feedback would be appreciated. big_smile

Offline

#2 2009-02-04 02:22:58

Schneibster
Member
Registered: 2008-12-20
Posts: 32

Re: I edited the NetworkManager page

With 48 hits, at least some of whom must have gone and looked, I guess that'll do.

Offline

#3 2009-02-04 04:32:01

u_no_hu
Member
Registered: 2008-06-15
Posts: 453

Re: I edited the NetworkManager page

This is purely my personal opinion and i am nobody to talk about the wiki style..... 

Note: I found this naming trick useful for the following items: a_portmap b_netfs c_ntpdate d_ntpd e_cups f_clamav I run a local NTP server, and do not connect my laptop to foreign wireless networks. I also make NFS mounts. There's no point in cups if you're not on the network. Clamav's freshclam signature updater requires networking to connect. I may hack on it some to separate the freshclam service from the clamav on-access scanner so I can keep the on-access scanner running all the time but only run freshclam when the networking is up.

Try re-phrasing it such a way to remove all those "I found", "I run" "I may"etc.. basically all the "I did this stuff" because it is a wiki page where everybody contributes, there is no "I". Again this is purely my personal opinion and others may disagree.


Don't be a HELP VAMPIRE. Please search before you ask.

Subscribe to The Arch Daily News.

Offline

#4 2009-02-04 23:13:59

Schneibster
Member
Registered: 2008-12-20
Posts: 32

Re: I edited the NetworkManager page

I agree as a general practice in the body of a procedure, but I found quite a few articles where this was done. People add notes and put them in italics and mention their own experiences using procedures from the Wiki, and this seems to be a common practice across the wiki. In fact, there were other such notes in that very article that I didn't put in it. They're more in the nature of comments than the actual text of the article. In a final version, one would hope that such things could be removed; I might look again in a week or two and see if I think there's a good way to get that information out of the first-person mode and into the body.

Thanks for the feedback.

Offline

#5 2009-02-05 02:12:02

Misfit138
Misfit Emeritus
From: USA
Registered: 2006-11-27
Posts: 4,189

Re: I edited the NetworkManager page

u_no_hu wrote:

......Try re-phrasing it such a way to remove all those "I found", "I run" "I may"etc.. basically all the "I did this stuff" because it is a wiki page where everybody contributes, there is no "I"..

Agreed.
We are trying to make the Archwiki as formal and professional as possible. Conversational style does not really 'fit'. There are many excellent articles linked from the main page that can give you a good idea of the style we have been shooting for.
Thanks for taking the time.

Offline

Board footer

Powered by FluxBB