split up my article/project?

Question

0.00/5 (No votes)

See more:

I am uploading my first attempt at a project article and I would appreciate some advice.

The project is a mature bulk/batch file renamer. It contains code to sense when a drive is mounted or dismounted so that the drive list is always up to date. It also contains a 'file(s) changed' sensing class to keep that display list up to date. It has a better user interface and more choices on prefix, suffix, infix with add, delete, and replace values supplied by the user. It also has a preview column next to the 'current' column so you can see the effects before you execute.

I am currently writing an article covering the entire project with not a lot about the fairly mundane code for spinning through a file list and changing the names. Instead I have spent more time explaining the processes for sensing drive and file changes and then how to create, raise, and consume async events.

My question is should I split this up and write shorter, concentrated articles on sensing drive changes, sensing file changes, and how to create and utilize events, or should I keep it as a whole (or all of the above)?

Posted 7-Nov-12 11:12am

chuck in st paul

Add a Solution

2 solutions

Solution 2

If it's already complete in one part then post it and see what comments or suggestions you receive.

Posted 8-Nov-12 0:03am

Richard MacCutchan

Comments

Sergey Alexandrovich Kryukov 13-Nov-12 17:31pm

[OP commented:]

I am going to keep it together and add a 'table of contents' near the head of the article so folks can jump to the 'events', 'disk change notification', or 'file change notification' elements of the article, or read through the application notes and then into those other items. Thanks for the suggestions guys.

Add a Solution

Add your solution here

Treat my content as plain text, not as HTML

Preview 0

…

Existing Members

Sign in to your account

...or Join us

Download, Vote, Comment, Publish.

Your Email
Password
Forgot your password?

Your Email
This email is in use. Do you need your password?
Optional Password

I have read and agree to the Terms of Service and Privacy Policy
Please subscribe me to the CodeProject newsletters

When answering a question please:

Read the question carefully.
Understand that English isn't everyone's first language so be lenient of bad spelling and grammar.
If a question is poorly phrased then either ask for clarification, ignore it, or edit the question and fix the problem. Insults are not welcome.
Don't tell someone to read the manual. Chances are they have and don't get it. Provide an answer or move on to the next question.

Let's work to help developers, not make them feel stupid.

This content, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Sergey Alexandrovich Kryukov · Accepted Answer · 2012-11-07T12:43:00

Solution 1

I would prefer to read in one source. You are not limited by the volume. In the article content and table of content, divide the article in two distinct parts: on the utility and the technologies, and in the second part, write sub-division of handling of drive and file changes. This is up to you though, but in all cases, preserve cross-reference between different parts very clearly.

—SA

Posted 7-Nov-12 12:43pm

Sergey Alexandrovich Kryukov

Comments

Nelek 13-Nov-12 16:36pm

Op answered to you and richard in solution 3

Sergey Alexandrovich Kryukov 13-Nov-12 17:32pm

Thank you, Nelek.
I copied this post as a comment and removed the "solution", which I recommend to do in such cases.
--SA

Nelek 13-Nov-12 17:38pm

You are welcome. I usually do it as well, but as it was for more comments I didn't want to repeat it. Next time I'll do as always and done ;)

Sergey Alexandrovich Kryukov 13-Nov-12 17:54pm

This is great. Thanks again.
I notified Richard and warned OP against false solutions, it should help...
Cheers.
--SA

Sergey Alexandrovich Kryukov 13-Nov-12 17:27pm

[OP commented:]

I am going to keep it together and add a 'table of contents' near the head of the article so folks can jump to the 'events', 'disk change notification', or 'file change notification' elements of the article, or read through the application notes and then into those other items.

Thanks for the suggestions guys.

Sergey Alexandrovich Kryukov 13-Nov-12 17:30pm

For chuck in st paul:
Please, don't post texts like this one as "solution" -- "Add your solution here" is reserved for the posts intended to help the one who asked a question. Such false "solutions" will removed, no one gets notification. You should add comments to other posts.

Thank you,
--SA