|
|
|||||||||
|
|||||||||
| |||||||||
|
|
|
| |||||||||
![]() |
|
|
«
Previous Thread
|
Next Thread
»
|
Thread Tools | Search this Thread | Rate Thread | Display Modes |
|
|
|
Stop making mediocre tutorials.The best tutorials are video! Camtasia Studio makes it easy to create engaging, buzz-building screen videos at any size, in any popular format. Download the free trial!
|
|
#1
|
|||
|
|||
|
Please Read The CF Docs Before Posting!
I'm all for helping folks with their questions, that's why I prowl these forums.
However, over the last few months there have been some posts from people who seem to want the answer to a question without even attempting to determine the answer on their own first. CF has very good documentation, and the answer to virtually any basic question can be found there with minimal effort: http://livedocs.macromedia.com/cold...ef=part_dev.htm If you have a question about a tag or a function, please read the documentation first. If, after making an attempt to determine the answer, you still have problems, then post. Trust me on this: over time, you'll be far better off and more self-sufficient if you get used to looking for answers on your own first, and learn how to search and use the documentation. Thanks for your attention. Last edited by kiteless : October 24th, 2006 at 12:57 AM. |
|
#2
|
||||
|
||||
|
I disagree,
Coldfusion has horrible documentation when compared to PHP. Even worse, there is no search function, or at least that I can find in the more than 48 hours I have spent there. The documentation is also not color coded. Finally, the sample code does not represent all of the possiblities, and the output of the sample code is not provided. However, The documentation does work to some extent, especially for novices, if you already know the name of the tag or function your looking for. Alternativly the best source I know of is Google. |
|
#3
|
|||
|
|||
|
Tac, whether you think PHP has better documentation or not is totally irrelevant to this post. Please refrain from these sorts of comparisons as neither I, nor anyone else using CF, could care less what the PHP documentation looks like.
Further, you are totally wrong. The ColdFusion documentation crushes the PHP documentation. The PHP docs do little more than explain the functions. The CF docs are thousands of pages long and have massive sections on actually building applications and using CF in common scenarios. I suggest you go look through all of the documentation before you make any more absurd statements like this...it makes you look really uninformed. And there is a search button right there in the table of contents of that link...you looked around for 48 hours and didn't notice that?! ![]() Edit: You also won't find anything nearly as good as the CFMX 7 Snippet Explorer (part of the Getting Started Tutorial) in any of the PHP docs.
__________________
Ask if you have a question, but also help answer questions that you have knowledge of! Thanks, Brian. How to Post a Question in the Forums Last edited by kiteless : July 24th, 2005 at 09:47 PM. |
|
#4
|
||||
|
||||
|
First Let me start of by mentioning that I am using CF MX 6.1. Therefor, I clicked you original link as follows:
http://livedocs.macromedia.com/cold.../6.1/index.html If you go there, you will note that there is no search feature for CF 6.1 MX there, the second link you gave, which is not the same as the first, is for CF MX 7.0. I like that coldfusion snippet link you gave, the only problem is that link never showed up in any of my google searches and I never found it while looking through the doc's on the tags. Many of those snippets are just explaining a tag like <cfoutput> or <cfquery> or an if/else statement, it would have been wonderful if Coldfusion included these code snippets and their output in the actual code documenation... for example here http://livedocs.macromedia.com/coldfusion/6.1/htmldocs/tags-b19.htm#wp1102316 As for the PHP documentation, there is no need for the snippet explorer. First, each possible variation of a tag or if/else statement is given in the examples, and the output of each is explained there taking care of the snippet explorer's purpose. Secondly, for more advanced functions the comments are filled with comments, but there is no way I can argue that PHP's comments are more valuable to comments on Coldfusion documentation, although I seem to find many more with advanced functions and implementations that are just what I need. |
|
#5
|
|||
|
|||
|
With regard to the comments, which I would expand to include any related documentation beyond the simple tag and function descriptions, is exactly what the other 5000 pages of the CF documentation provide. Again, I promise you, there is nothing in the PHP docs even close to the depth of explanation contained in the Developer's Guide, Administrator's Guide, Getting Started Guide, etc. In fact I'd much rather read advice and explanations from the actual language creators than from random commentors.
But I digress...the real point of my reply was to completely refute your original statement that the "CF documentation is horrible", which as anyone who looks at it can see is just flat out false. ![]() |
![]() |
| Viewing: Dev Shed Forums > Programming Languages - More > ColdFusion Development > Please Read The CF Docs Before Posting! |
| Thread Tools | Search this Thread |
| Display Modes | Rate This Thread |
|
|
|
|
|