Image
 
linkedin_logo.png rss_logo.jpg
twitter_logo.png youtube_logo.jpg
Latest Additions
 
EH-Net Login
Welcome Guest.






Lost Password?
No account yet? Register
Who's Online
We have 27 guests online
 
Advertisement

You are here: Home arrow Featuresarrow Opinionsarrow Writing articles - using "you" or "it"?
EH-Net
May 25, 2013, 12:28:52 PM *
Welcome, Guest. Please login or register.
Did you miss your activation email?

Login with username, password and session length
News: Go back to The Ethical Hacker Network Online Magazine Home Page
 
   Home   Help Calendar Login Register  
Pages: [1]   Go Down
  Print  
Author Topic: Writing articles - using "you" or "it"?  (Read 14634 times)
0 Members and 1 Guest are viewing this topic.
UNIX
Hero Member
*****
Offline Offline

Posts: 1235


View Profile
« on: June 15, 2009, 08:27:12 AM »

Hello,
not really technically but something I am thinking a little bit about.
The questions is if it is more "professional" or "better" to write something with using the word "you" or something in more general like "it" and not addressing to any person.

Examples what i mean:
1) Before you can use this feature you have to enable it in the settings.
2) Before this feature can be used it has to be enabled in the settings.

1) While the tests nothing odd happened.
2) While my tests nothing odd happened.

As English is not my main language I would like to know which is better to use and which do you personally prefer in articles, reviews etc.

Only thing I came up with is that you should use whatever you choose for the whole article.
« Last Edit: June 15, 2009, 08:29:47 AM by UNIX » Logged
ethicalhack3r
Full Member
***
Offline Offline

Posts: 139


View Profile WWW
« Reply #1 on: June 15, 2009, 09:12:49 AM »

Quote
The questions is if it is more "professional" or "better" to write something with using the word "you" or something in more general like "it" and not addressing to any person.

Not too sure to be honest.
Quote
1) Before you can use this feature you have to enable it in the settings.
2) Before this feature can be used it has to be enabled in the settings.

2) Sounds/looks better.
Quote
1) While the tests nothing odd happened.
2) While my tests nothing odd happened.

Depends on whether or not your reffering to YOUR tests or some one elses tests.

While should be replaced with 'during'.

2) During my tests nothing odd happened.
or
2) While carrying out my tests nothing odd happened.

I have a powerpoint presentation from uni on writting reports I can send you if you wish.
Logged
UNIX
Hero Member
*****
Offline Offline

Posts: 1235


View Profile
« Reply #2 on: June 15, 2009, 09:37:57 AM »

That would be nice and much appreciated. Smiley

The two sentences were just examples. I am writing all articles and reviews by myself of course, but personally I think it is better to write in a general style although the readers may then not be as appealed (hope this is the correct word for this) as in the other way.
« Last Edit: June 15, 2009, 09:49:52 AM by UNIX » Logged
ethicalhack3r
Full Member
***
Offline Offline

Posts: 139


View Profile WWW
« Reply #3 on: June 15, 2009, 10:07:33 AM »

Sent you the slides, hope they are useful to you.
Logged
BillV
Hero Member
*****
Offline Offline

Posts: 1892


View Profile WWW
« Reply #4 on: June 15, 2009, 10:10:15 AM »

Don may have some good advice for you here Smiley

I am not an English major, so I'm not sure if one is supposed to be better than the other.

As for your examples above, I would select #2 - "before this feature can be used it has to be enabled in the settings."

And also as you've mentioned, being consistent is key.
Logged
UNIX
Hero Member
*****
Offline Offline

Posts: 1235


View Profile
« Reply #5 on: June 15, 2009, 10:35:06 AM »

Thanks for your thoughts and especially thanks for the slides, ethicalhack3r. Smiley I will read through them this week.

Yeah, I thought EH may be a good place for my question as there are some great authors and writers.
Logged
don
Editor-In-Chief
Administrator
Hero Member
*****
Offline Offline

Posts: 4169


Editor-In-Chief


View Profile WWW
« Reply #6 on: June 15, 2009, 10:47:28 AM »

Hey UNIX,

Great thread as many ask about ways to boost their resume, and writing is definitley one of those ways.

Using "you" is considered less professional. So it depends on your style and the purpose of the writing. As an example, for an opinion piece to a tech crowd or something that is less formal, "you" is fine. For a press release, "you" is frowned upon.

As an aside, "you" is also recommended to be removed from your vocabulary when dealing with people in technical manners whether it is desktop support or reviewing reports from your pen tests. People react less harshly when you state a comment about a problem and don't use "you." Studies and experience show that they take it personally. Although as techies we could honestly say that it is their desktop or their organization, so it IS their fault. People just don't like to hear it. And thus the problems get resolved with less pain on both ends.

Hope that helps,
Don
Logged

CISSP, MCSE, CSTA, Security+ SME
unsupported
Sr. Member
****
Offline Offline

Posts: 318


Unofficial Newbie Moderator


View Profile
« Reply #7 on: June 15, 2009, 10:55:42 AM »

I've dabbled in technical writing my entire career I find it easier just to rewrite the sentences without needing to rely on the word.

For example:
1) Before you can use this feature you have to enable it in the settings.
2) Before this feature can be used it has to be enabled in the settings.

This feature needs to be enabled before use.

1) While the tests nothing odd happened.
2) While my tests nothing odd happened.

Nothing odd happened during the tests.

It is a tricky and sticky slope when trying to be formal and technical.

Using the MLA format, popular in college, may be a good start.  http://grammar.ccc.commnet.edu/grammar/
Logged

-Un
CISSP, GCIH, GCIA, C|EH, Sec+, Net+, MCP
Ignatius
Jr. Member
**
Offline Offline

Posts: 91


View Profile
« Reply #8 on: June 15, 2009, 01:35:49 PM »

I agree with don and unsupported.  I've written many reports (not related to IT) and have never used the second person ("you").  If I have to, I use the third person, but prefer to avoid the situation by rephrasing the sentences as suggested by unsupported.

I'd be happy to look through the article for you awesec, providing it isn't a 10,000 word thesis!
Logged
Ketchup
Hero Member
*****
Offline Offline

Posts: 1021



View Profile
« Reply #9 on: June 15, 2009, 02:02:22 PM »

This is fantastic information.  I am really glad this thread was started.   Of course, now I have to go back and do some minor revisions on a report I thought I had finished Smiley

For those of you who are writers, do you have any recommendations for some literature on technical writing?
Logged

~~~~~~~~~~~~~~
Ketchup
Ants
Newbie
*
Offline Offline

Posts: 25


View Profile
« Reply #10 on: June 15, 2009, 05:42:24 PM »

Hi awesec,

I agree, this is an interesting post.

I have to say that I am jealous of your English, it is very good considering that it is not your main language. I regret that as a native English speaker I never learned another language.

I agree with don, try to avoid the 'you' word; people take it personally and may get offended.

I like the http://www.guardian.co.uk/styleguide. It might not be what you are looking for but it hi-lights some of the more common errors in English writing.

Ants
Logged

CEH, GPEN, GCFW
UNIX
Hero Member
*****
Offline Offline

Posts: 1235


View Profile
« Reply #11 on: June 16, 2009, 12:22:02 AM »

Thanks for all replies done so far. This really helped me.

I used the time yesterday evening and corrected two reviews I have done recently and tried to adhere to the recommendations given. Especially as I haven't done any "public" articles and reviews in English yet this was very important for me. Also an English article I wrote will be printed this year by a security magazine. As I have still time until it must be delivered I will also reread it and correct if necessary.

Ants: Thanks for your kind words :>

I will also check the guide by guardian, thanks for mentioning it.
« Last Edit: June 16, 2009, 12:39:48 AM by awesec » Logged
former33t
Full Member
***
Offline Offline

Posts: 226


View Profile
« Reply #12 on: June 16, 2009, 07:20:11 PM »

I'm late on this, but for what little it is worth, I completely agree with unsupported.  Rephrasing to include as few words as possible (without using "you") is best.  It is an art though.  Luckily my wife majored in communications, so I have a proofreader at home.
Logged

Certifications: CREA, MCSE: Security, CCNA, Security+, other junk
UNIX
Hero Member
*****
Offline Offline

Posts: 1235


View Profile
« Reply #13 on: July 09, 2009, 03:21:51 AM »

Since my last post in this thread I was able to rephrase everything I have written so far for magazines etc., which was not published yet, so thank you very much. Smiley
Gladly I only found a few sentences where I used it by accident.

Also I checked articles which where already published and found that I haven't used any form of you in them. Smiley
Logged
Pages: [1]   Go Up
  Print  
 
Jump to:  

Powered by MySQL Powered by PHP Powered by SMF 1.1.18 | SMF © 2013, Simple Machines
Joomla Bridge by JoomlaHacks.com
Valid XHTML 1.0! Valid CSS!
Page created in 0.127 seconds with 24 queries.
 
Exclusive Deal

sansfire13_245x90_cw90.jpg
SANSFIRE 2013
June 15 - 22

5% Off w/ Code: EHN_5

SANS Deals 4 EH-Netters
5% OFF Any SANS Course in Any Format!
Coupon Code: EHN_5 Including SANS Rocky Mountain 2013 & SANS Boston 2013
Polls
Compared to this year, 2013 will be:
 
Recent Forum Topics
EH-Net News Feeds
Latest Additions
 
         
Advertisement

© 2013 The Ethical Hacker Network
Joomla! is Free Software released under the GNU/GPL License.