Update help (more) and new tutorials

Jul 5, 2018
1
0
#1
Hi,

this is my first post, here is my suggestion. For a long time I've been coming to see the site and hoping that new documentation in the form of help files and simple tutorials will be in place. I read in one of your documents that there would be new tutorials coming soon however that was some time ago and they don't appear to be any new ones. I'm not a geek so when I look at some of the documentation I find it somewhat perplexing. I can give you an example - most people have a lot of duplication of files and folders especially music folders but they may also have documents and so forth so I thought I would look at your new deDupe command the first thing I note is that it mentions a range I now have to go to another part of the documentation to find out what that is I assume it's a set of files or folders but I'm not sure how to input them, I then see that effectively I can just put in deDupe then a filename followed by a directory and I have an option if I want to change a duplicated file to be symlinked to the first file that it found. In the documentation it also mentions an option of /S being linked to a d setting which appears to be an option of /N I guess the capital N is substituted by a d but then only if /S is used.
I note that /S hasn't been defined I assume it means search what was defined was /Sn which is to search subdirectories there is mention of s/[n] so shouldn't it have been like that in the line above? I only want to be able to search through a given directory and find duplicates of anything, however it seems that I have to specify a particular file. Maybe I'm stupid I'm not a geek I believe that your product could be better if the documentation could be improved (I know it has had a recent make over) and in particular some simple video tutorials of using common commands hi-lighting their use and pointing out common scenarios where certain options may be helpful or necessary. It would also be nice for an explanation as to not just how to use particular option but why you should use it in this particular context over some other option. It needs to be written in a way a non geek can comprehend.
 
#2
I've always liked referencing the SS64.org site.

Detailed information is available for each command, along with examples, gotcha's, tips and tricks.

Example: For /F

Mind you, the TCMD help for FOR is quite extensive also.

I downloaded the site back in 2016, and made a .CHM help file. As the site is always being updated, I supposed I should download the site again, and make an updated .CHM file.

It would be great if the TCMD Help file was designed similar to SS64.

Joe
 

rconn

Administrator
Staff member
May 14, 2008
10,495
94
#3
The issue with (greatly) expanding the help is its poor cost/benefit ratio. The current help is already around 1,400 pages (!) - expanding that to the extent requested raises some concerns for me.

1) Writing this much new help would require a *lot* of time, which means forgoing at least one, probably two major updates.
2) Most of the users rarely look at the help -- except to look up an obscure feature and then grumble that there isn't a tutorial on how to use it.
3) Everybody says they want more help, but NOBODY is going to pay for an update with lots of new help & no new features.
4) So I'll be working for free for a year or two - which decreases the likelihood that there would ever be a new feature version.

But if enough users sign up for Extended Support solely so they can get an expanded help file, it's something I'd consider.
 
#4
How about something like this -- (just "something quick off the top of my head". I haven't thought this through in detail.)

Assign each help entry a reference number. Then have some way to link to an "Additional Help Information" forum based on the reference number. And there users could add information, such as sample code.

So let's say the DIR command is ref 04295. I click "Additional Help Info" and it links to the Additional Help forum and sets up a search for all entries where the topic begins with 04295. Entering a new post topic would require beginning with a reference number, just like the How To options are available.
 
#5
Related to that, if there is a way to track how many searches there are for the different reference numbers, that would help showing which ones do need the built-in Help expanded. Most likely there would be 20-50 commands, variables, etc., that get the vast majority of requests.