What does CPians expect from an article on CP
-
Hi Everybody, I looked at my article's rating and it is just around 2. I thought about it and had a question. What do CPians expect from an article ? Whether it should be completly technical always ? Whether it should cover the topic in great details ? Should there always be a project (ZIP) with the article ? I am sure that the answers will be person dependant, but that will help the new writers or rather users wanting to express themselves, learn the art of writing. And also, please dont misunderstand me for my question. I just want to know how to present your bit of knowledge in a more acceptable format ? I request you all to put in your comments / expectation about article writing so that every one here will benefit / correct there errors. Thanks !
"A good programmer is someone who looks both ways before crossing a one-way street." -- Doug Linder
coolestCoder
-
Hi Everybody, I looked at my article's rating and it is just around 2. I thought about it and had a question. What do CPians expect from an article ? Whether it should be completly technical always ? Whether it should cover the topic in great details ? Should there always be a project (ZIP) with the article ? I am sure that the answers will be person dependant, but that will help the new writers or rather users wanting to express themselves, learn the art of writing. And also, please dont misunderstand me for my question. I just want to know how to present your bit of knowledge in a more acceptable format ? I request you all to put in your comments / expectation about article writing so that every one here will benefit / correct there errors. Thanks !
"A good programmer is someone who looks both ways before crossing a one-way street." -- Doug Linder
coolestCoder
You can check out this guidelines which should help you with the answers to most of the queries: http://www.codeproject.com/KB/scrapbook/whatisagoodarticle.aspx[^]
Vasudevan Deepak Kumar Personal Homepage
Tech Gossips
A pessimist sees only the dark side of the clouds, and mopes; a philosopher sees both sides, and shrugs; an optimist doesn't see the clouds at all - he's walking on them. --Leonard Louis Levinson -
Hi Everybody, I looked at my article's rating and it is just around 2. I thought about it and had a question. What do CPians expect from an article ? Whether it should be completly technical always ? Whether it should cover the topic in great details ? Should there always be a project (ZIP) with the article ? I am sure that the answers will be person dependant, but that will help the new writers or rather users wanting to express themselves, learn the art of writing. And also, please dont misunderstand me for my question. I just want to know how to present your bit of knowledge in a more acceptable format ? I request you all to put in your comments / expectation about article writing so that every one here will benefit / correct there errors. Thanks !
"A good programmer is someone who looks both ways before crossing a one-way street." -- Doug Linder
coolestCoder
Problem is some visitors to your article will simply be looking for a quick answer and solution to their problem (homework/assignment :P) and if they don't get it they will get annoyed and mod down your page.
He who makes a beast out of himself gets rid of the pain of being a man
-
Hi Everybody, I looked at my article's rating and it is just around 2. I thought about it and had a question. What do CPians expect from an article ? Whether it should be completly technical always ? Whether it should cover the topic in great details ? Should there always be a project (ZIP) with the article ? I am sure that the answers will be person dependant, but that will help the new writers or rather users wanting to express themselves, learn the art of writing. And also, please dont misunderstand me for my question. I just want to know how to present your bit of knowledge in a more acceptable format ? I request you all to put in your comments / expectation about article writing so that every one here will benefit / correct there errors. Thanks !
"A good programmer is someone who looks both ways before crossing a one-way street." -- Doug Linder
coolestCoder
Some time ago I found this very interesting article: http://www.computer.org/portal/cms\_docs\_transactions/transactions/tpami/freecontent/taskoftheferee.pdf It mainly talks about the task of a referee for scientific papers, i.e. the person who reviews articles in order to decide whether they should be published. However, if you look at the things the referee has to check (section "Evaluating a research paper") you can self-check your article to see if it meets good standards. Now, obviously CP is a community more than a scientific organization, and your articles are published anyway, so you don't have to worry about a very strict reviewer... but I think that what scientific reviewers expect is what normal readers expect as well, maybe unconsciously. So I hope this will help you.
-+ HHexo +-
-
You can check out this guidelines which should help you with the answers to most of the queries: http://www.codeproject.com/KB/scrapbook/whatisagoodarticle.aspx[^]
Vasudevan Deepak Kumar Personal Homepage
Tech Gossips
A pessimist sees only the dark side of the clouds, and mopes; a philosopher sees both sides, and shrugs; an optimist doesn't see the clouds at all - he's walking on them. --Leonard Louis LevinsonThanks for the link, I will surely go through it. But I was expecting personal comments rather than guidelines, which ofcourse are usefull.
"A good programmer is someone who looks both ways before crossing a one-way street." -- Doug Linder
coolestCoder
-
Problem is some visitors to your article will simply be looking for a quick answer and solution to their problem (homework/assignment :P) and if they don't get it they will get annoyed and mod down your page.
He who makes a beast out of himself gets rid of the pain of being a man
Yes. This can be one of the reasons. So do you think, including a summary section at the top of your article will minimize this thing ?
"A good programmer is someone who looks both ways before crossing a one-way street." -- Doug Linder
coolestCoder
-
Thanks for the link, I will surely go through it. But I was expecting personal comments rather than guidelines, which ofcourse are usefull.
"A good programmer is someone who looks both ways before crossing a one-way street." -- Doug Linder
coolestCoder
What is it with programmers and guidelines ?? :doh:
Cheers, Mircea "Pay people peanuts and you get monkeys" - David Ogilvy
-
Hi Everybody, I looked at my article's rating and it is just around 2. I thought about it and had a question. What do CPians expect from an article ? Whether it should be completly technical always ? Whether it should cover the topic in great details ? Should there always be a project (ZIP) with the article ? I am sure that the answers will be person dependant, but that will help the new writers or rather users wanting to express themselves, learn the art of writing. And also, please dont misunderstand me for my question. I just want to know how to present your bit of knowledge in a more acceptable format ? I request you all to put in your comments / expectation about article writing so that every one here will benefit / correct there errors. Thanks !
"A good programmer is someone who looks both ways before crossing a one-way street." -- Doug Linder
coolestCoder
At first look, better formating would definitely help. At the second look, some working example would be nice (yes, downloadable project). btw you say one of missing features in NUnit is UI testing, and then you say "UI testing is not supported in the current version of unit testing with VS.NET 2008". Which is NOT, imho, something anyone is interested to know :) Also I don't know if "4. You cannot run NUnit test cases from within VS.NET 2008. You will need separate EXE to do that (The NUnit framework)" is true, at least for VS2005 there are ways how to integrate NUnit (from run as external tool to TestDriven.NET or similar plugin).
[My Blog]
"Visual studio desperately needs some performance improvements. It is sometimes almost as slow as eclipse." - Rüdiger Klaehn
"Real men use mspaint for writing code and notepad for designing graphics." - Anna-Jayne Metcalfe -
Some time ago I found this very interesting article: http://www.computer.org/portal/cms\_docs\_transactions/transactions/tpami/freecontent/taskoftheferee.pdf It mainly talks about the task of a referee for scientific papers, i.e. the person who reviews articles in order to decide whether they should be published. However, if you look at the things the referee has to check (section "Evaluating a research paper") you can self-check your article to see if it meets good standards. Now, obviously CP is a community more than a scientific organization, and your articles are published anyway, so you don't have to worry about a very strict reviewer... but I think that what scientific reviewers expect is what normal readers expect as well, maybe unconsciously. So I hope this will help you.
-+ HHexo +-
Thanks alot ! I will surely check the link.
"A good programmer is someone who looks both ways before crossing a one-way street." -- Doug Linder
coolestCoder
-
At first look, better formating would definitely help. At the second look, some working example would be nice (yes, downloadable project). btw you say one of missing features in NUnit is UI testing, and then you say "UI testing is not supported in the current version of unit testing with VS.NET 2008". Which is NOT, imho, something anyone is interested to know :) Also I don't know if "4. You cannot run NUnit test cases from within VS.NET 2008. You will need separate EXE to do that (The NUnit framework)" is true, at least for VS2005 there are ways how to integrate NUnit (from run as external tool to TestDriven.NET or similar plugin).
[My Blog]
"Visual studio desperately needs some performance improvements. It is sometimes almost as slow as eclipse." - Rüdiger Klaehn
"Real men use mspaint for writing code and notepad for designing graphics." - Anna-Jayne MetcalfeI think I was not able to present somethings correctly or more precisely.
dnh wrote:
you say one of missing features in NUnit is UI testing
I didnt meant this. I wanted to state that UI testing is not possible in VS.NET 2008, but it is possible in NUnit.
dnh wrote:
Also I don't know if "4. You cannot run NUnit test cases from within VS.NET 2008. You will need separate EXE to do that (The NUnit framework)" is true, at least for VS2005 there are ways how to integrate NUnit (from run as external tool to TestDriven.NET or similar plugin).
Here also, I was not very precise in telling that, using the 'Run' menu you cannot execute NUnit test cases. So to execute NUnit test cases, same approach as you described needs to be followed. This is the reason I posted the question about expectations. I personally am a reader and have some thoughts. I will try my best to be precise next time I write any article / reply. Thanks !
"A good programmer is someone who looks both ways before crossing a one-way street." -- Doug Linder
coolestCoder
-
Hi Everybody, I looked at my article's rating and it is just around 2. I thought about it and had a question. What do CPians expect from an article ? Whether it should be completly technical always ? Whether it should cover the topic in great details ? Should there always be a project (ZIP) with the article ? I am sure that the answers will be person dependant, but that will help the new writers or rather users wanting to express themselves, learn the art of writing. And also, please dont misunderstand me for my question. I just want to know how to present your bit of knowledge in a more acceptable format ? I request you all to put in your comments / expectation about article writing so that every one here will benefit / correct there errors. Thanks !
"A good programmer is someone who looks both ways before crossing a one-way street." -- Doug Linder
coolestCoder
When writing an article ask yourself "Does this have Zing?" Zing is the hook that draws you in. It's the feeling that the article is giving you what you want. It's sex appeal. A good article leaves you feeling a little bit dirty. Ahem. Perhaps I need to get out more.
Deja View - the feeling that you've seen this post before.
-
Hi Everybody, I looked at my article's rating and it is just around 2. I thought about it and had a question. What do CPians expect from an article ? Whether it should be completly technical always ? Whether it should cover the topic in great details ? Should there always be a project (ZIP) with the article ? I am sure that the answers will be person dependant, but that will help the new writers or rather users wanting to express themselves, learn the art of writing. And also, please dont misunderstand me for my question. I just want to know how to present your bit of knowledge in a more acceptable format ? I request you all to put in your comments / expectation about article writing so that every one here will benefit / correct there errors. Thanks !
"A good programmer is someone who looks both ways before crossing a one-way street." -- Doug Linder
coolestCoder
I would say also that there is not anything of much in there that you cannot get from the MSDN documentation - having some examples of working unit tests would be much more useful.
-
When writing an article ask yourself "Does this have Zing?" Zing is the hook that draws you in. It's the feeling that the article is giving you what you want. It's sex appeal. A good article leaves you feeling a little bit dirty. Ahem. Perhaps I need to get out more.
Deja View - the feeling that you've seen this post before.
Pete O'Hanlon wrote:
When writing an article ask yourself "Does this have Zing?" Zing is the hook that draws you in. It's the feeling that the article is giving you what you want. It's sex appeal. A good article leaves you feeling a little bit dirty.
If my wife were to read this, she won't believe my late nights were being spent with having some good clean fun with my CP friends or learning by reading articles. ;P
"Every time Lotus Notes starts up, somewhere a puppy, a kitten, a lamb, and a baby seal are killed. Lotus Notes is a conspiracy by the forces of Satan to drive us over the brink into madness. The CRC-32 for each file in the installation includes the numbers 666." Gary Wheeler "Programming today is a race between software engineers striving to build bigger and better idiot-proof programs, and the Universe trying to produce bigger and better idiots. So far, the Universe is winning." - Rick Coo
-
When writing an article ask yourself "Does this have Zing?" Zing is the hook that draws you in. It's the feeling that the article is giving you what you want. It's sex appeal. A good article leaves you feeling a little bit dirty. Ahem. Perhaps I need to get out more.
Deja View - the feeling that you've seen this post before.
Pete O'Hanlon wrote:
A good article leaves you feeling a little bit dirty.
... what are you subscribed to?
Cheers, Mircea "Pay people peanuts and you get monkeys" - David Ogilvy
-
Hi Everybody, I looked at my article's rating and it is just around 2. I thought about it and had a question. What do CPians expect from an article ? Whether it should be completly technical always ? Whether it should cover the topic in great details ? Should there always be a project (ZIP) with the article ? I am sure that the answers will be person dependant, but that will help the new writers or rather users wanting to express themselves, learn the art of writing. And also, please dont misunderstand me for my question. I just want to know how to present your bit of knowledge in a more acceptable format ? I request you all to put in your comments / expectation about article writing so that every one here will benefit / correct there errors. Thanks !
"A good programmer is someone who looks both ways before crossing a one-way street." -- Doug Linder
coolestCoder
Just look at any article rated 4 or higher by at least 5-10 people, that will give you a good indication. Sometimes all you need are a few words to make an impact, sometimes you need a lot more to explain something small.
xacc.ide - now with IronScheme support
IronScheme - 1.0 alpha 1 out now -
Pete O'Hanlon wrote:
When writing an article ask yourself "Does this have Zing?" Zing is the hook that draws you in. It's the feeling that the article is giving you what you want. It's sex appeal. A good article leaves you feeling a little bit dirty.
If my wife were to read this, she won't believe my late nights were being spent with having some good clean fun with my CP friends or learning by reading articles. ;P
"Every time Lotus Notes starts up, somewhere a puppy, a kitten, a lamb, and a baby seal are killed. Lotus Notes is a conspiracy by the forces of Satan to drive us over the brink into madness. The CRC-32 for each file in the installation includes the numbers 666." Gary Wheeler "Programming today is a race between software engineers striving to build bigger and better idiot-proof programs, and the Universe trying to produce bigger and better idiots. So far, the Universe is winning." - Rick Coo
When I leave CodeProject, I feel low down dirty. ;)
Deja View - the feeling that you've seen this post before.
-
Hi Everybody, I looked at my article's rating and it is just around 2. I thought about it and had a question. What do CPians expect from an article ? Whether it should be completly technical always ? Whether it should cover the topic in great details ? Should there always be a project (ZIP) with the article ? I am sure that the answers will be person dependant, but that will help the new writers or rather users wanting to express themselves, learn the art of writing. And also, please dont misunderstand me for my question. I just want to know how to present your bit of knowledge in a more acceptable format ? I request you all to put in your comments / expectation about article writing so that every one here will benefit / correct there errors. Thanks !
"A good programmer is someone who looks both ways before crossing a one-way street." -- Doug Linder
coolestCoder
The first thing I look for from an article is a reason to carry on reading past the first paragraph. I'm not saying you have to have a plot - but an introduction saying what problem CFoobleClass will solve would be nice. Or, "I tried X, and failed miserably - so I did lots of research, and here is a guide", or... Etc. If it's for something graphical, a picture (in differing state) is probably next. Then two downloads - one for just the code that is new and shiny, and the other a demo app actually using the new-shiny thing. If it's showing off 20 lines of clever and gnarly code that can be cut and pasted into a function, then downloads are redundant. I try not to be too fussy about the quality of english (within reason) - but it does need to be readable, if not high literature. From memory. Marc Clifton wrote a very good guide on article writing. Feel free to ignore some of the points he makes, but do so for good reason, not neglect. I write articles for the Hero Worship that results - so the better the article, the better the groupies you'll get. So a bit of polish goes a long way. Iain.
-
Pete O'Hanlon wrote:
When writing an article ask yourself "Does this have Zing?" Zing is the hook that draws you in. It's the feeling that the article is giving you what you want. It's sex appeal. A good article leaves you feeling a little bit dirty.
If my wife were to read this, she won't believe my late nights were being spent with having some good clean fun with my CP friends or learning by reading articles. ;P
"Every time Lotus Notes starts up, somewhere a puppy, a kitten, a lamb, and a baby seal are killed. Lotus Notes is a conspiracy by the forces of Satan to drive us over the brink into madness. The CRC-32 for each file in the installation includes the numbers 666." Gary Wheeler "Programming today is a race between software engineers striving to build bigger and better idiot-proof programs, and the Universe trying to produce bigger and better idiots. So far, the Universe is winning." - Rick Coo
Mustafa Ismail Mustafa wrote:
she won't believe my late nights were being spent with having some good clean fun with my CP friends
So you are saying you don't want her to realise that you can --- never mind. I don't want my kid sister to read about all the fun things you can do on CP.
Jon Smith & Wesson: The original point and click interface
-
Mustafa Ismail Mustafa wrote:
she won't believe my late nights were being spent with having some good clean fun with my CP friends
So you are saying you don't want her to realise that you can --- never mind. I don't want my kid sister to read about all the fun things you can do on CP.
Jon Smith & Wesson: The original point and click interface
:laugh: Yes, I mean just that! :laugh:
"Every time Lotus Notes starts up, somewhere a puppy, a kitten, a lamb, and a baby seal are killed. Lotus Notes is a conspiracy by the forces of Satan to drive us over the brink into madness. The CRC-32 for each file in the installation includes the numbers 666." Gary Wheeler "Programming today is a race between software engineers striving to build bigger and better idiot-proof programs, and the Universe trying to produce bigger and better idiots. So far, the Universe is winning." - Rick Coo
-
The first thing I look for from an article is a reason to carry on reading past the first paragraph. I'm not saying you have to have a plot - but an introduction saying what problem CFoobleClass will solve would be nice. Or, "I tried X, and failed miserably - so I did lots of research, and here is a guide", or... Etc. If it's for something graphical, a picture (in differing state) is probably next. Then two downloads - one for just the code that is new and shiny, and the other a demo app actually using the new-shiny thing. If it's showing off 20 lines of clever and gnarly code that can be cut and pasted into a function, then downloads are redundant. I try not to be too fussy about the quality of english (within reason) - but it does need to be readable, if not high literature. From memory. Marc Clifton wrote a very good guide on article writing. Feel free to ignore some of the points he makes, but do so for good reason, not neglect. I write articles for the Hero Worship that results - so the better the article, the better the groupies you'll get. So a bit of polish goes a long way. Iain.
Thanks ! You explained in a good stepwise manner.
"A good programmer is someone who looks both ways before crossing a one-way street." -- Doug Linder
coolestCoder