Margo Noreen
Top achievements
Rank 1
Veteran
Rank 1
Veteran
Margo Noreen
asked on 19 Mar 2013, 03:13 PM
It does not appear your Online Help for RadControls for ASP.NET Ajax has been updated (http://www.telerik.com/help/aspnet-ajax/introduction.html).
I've downloaded the latest release (RadControlsForAspNetAjaxControlPanel_2013_1_220.exe). Your documentation does not reflect any information related to VS2012 or ASP.NET 4.5. The Control Panel installer was also new (no .msi as per usual?).
So, before I go too much deeper, I'm wondering how out-of-date the overall documentation is.
I've downloaded the latest release (RadControlsForAspNetAjaxControlPanel_2013_1_220.exe). Your documentation does not reflect any information related to VS2012 or ASP.NET 4.5. The Control Panel installer was also new (no .msi as per usual?).
So, before I go too much deeper, I'm wondering how out-of-date the overall documentation is.
5 Answers, 1 is accepted
0
Hello Margo,
Could you explain what exactly you find missing or outdated in our documentation, if you could include the links to the topics that would help us a lot. There are not many specific differences related to VS 2012 or .NET 4.5 that affect our controls, the IDE is still used like the VS2010 version. The main difference is that MS once again changed the way JavaScript intellisense works and this is explained here. On model binding you can read here.
Generally, we try to keep our documentation on par with the features the controls have in their latest version and you can see the date on which the online documentation was uploaded in the bottom right corner of the introduction page. Currently this is the 12th of March 2013.
On the installer - we have introduced a common control panel that you can use to manager all your products, yet you can still download an msi installer from your account by following the steps from this help article: Installing RadControls from MSI file.
Greetings,
Marin Bratanov
the Telerik team
Could you explain what exactly you find missing or outdated in our documentation, if you could include the links to the topics that would help us a lot. There are not many specific differences related to VS 2012 or .NET 4.5 that affect our controls, the IDE is still used like the VS2010 version. The main difference is that MS once again changed the way JavaScript intellisense works and this is explained here. On model binding you can read here.
Generally, we try to keep our documentation on par with the features the controls have in their latest version and you can see the date on which the online documentation was uploaded in the bottom right corner of the introduction page. Currently this is the 12th of March 2013.
On the installer - we have introduced a common control panel that you can use to manager all your products, yet you can still download an msi installer from your account by following the steps from this help article: Installing RadControls from MSI file.
Greetings,
Marin Bratanov
the Telerik team
If you want to get updates on new releases, tips and tricks and sneak peeks at our product labs directly from the developers working on the RadControls for ASP.NET AJAX, subscribe to their blog feed now.
0
Margo Noreen
Top achievements
Rank 1
Veteran
Rank 1
Veteran
answered on 22 Mar 2013, 01:20 PM
Well, I was just starting "from the top." For example, look at your "Installation and deployment" -> "Installing RadControls on your computer" section. In the "Which file do I need to install" page (http://www.telerik.com/help/aspnet-ajax/introduction-which-file-do-i-need-to-install.html), there's no mention of your new "Control Panel" based installer. That's not really that big of a deal, it just created an initial stumbling block, "this doesn't seem to match what's currently available" kind of thing.
Moving on down, you see specific pages for Adding Controls to the Visual Studio 2008 Toolbox (and also for VS2010), but not for 2012. Or, specific pages for Using Intellisense in Visual Studio 2008 (and also for 2010) but not for 2012. Again, not a huge deal, it just added to the mental adjustments and "hmmm, more things that don't seem to have been updated" bit.
So as I mentioned, before I kept going on down the documentation, I was wondering if you had made a pass at updating this recently. I've noticed MANY nuances in going to VS2012 and .NET 4.5, so I think it warrants careful attention to new documentation!
-- Margo
Moving on down, you see specific pages for Adding Controls to the Visual Studio 2008 Toolbox (and also for VS2010), but not for 2012. Or, specific pages for Using Intellisense in Visual Studio 2008 (and also for 2010) but not for 2012. Again, not a huge deal, it just added to the mental adjustments and "hmmm, more things that don't seem to have been updated" bit.
So as I mentioned, before I kept going on down the documentation, I was wondering if you had made a pass at updating this recently. I've noticed MANY nuances in going to VS2012 and .NET 4.5, so I think it warrants careful attention to new documentation!
-- Margo
0
Hi Margo,
Thank you for the additional information. We will consider updating the articles and here follows a brief explanation on why they seem outdated.
The first help article treats the files from which installation can be done and thus it does not directly relate to the control panel.
The other two articles for working with the VS toolbox are just pieces of general knowledge we had included in our documentation to help our clients. The first was created before there was VS 2010 and to prevent having broken links we have not removed either of them so far. The process is not much different with VS 2012, either, the toolbox functionality is primarily offered by VS and not directly by us, we are merely creating a standard .NET assembly that VS can use.
We do try to keep the documentation updated with the new features of the controls and this is why the new .NET 4.5 features we have added are present there. Nevertheless, should you have any other issues with our online help - do let us know so we can address them.
Kind regards,
Marin Bratanov
the Telerik team
Thank you for the additional information. We will consider updating the articles and here follows a brief explanation on why they seem outdated.
The first help article treats the files from which installation can be done and thus it does not directly relate to the control panel.
The other two articles for working with the VS toolbox are just pieces of general knowledge we had included in our documentation to help our clients. The first was created before there was VS 2010 and to prevent having broken links we have not removed either of them so far. The process is not much different with VS 2012, either, the toolbox functionality is primarily offered by VS and not directly by us, we are merely creating a standard .NET assembly that VS can use.
We do try to keep the documentation updated with the new features of the controls and this is why the new .NET 4.5 features we have added are present there. Nevertheless, should you have any other issues with our online help - do let us know so we can address them.
Kind regards,
Marin Bratanov
the Telerik team
If you want to get updates on new releases, tips and tricks and sneak peeks at our product labs directly from the developers working on the RadControls for ASP.NET AJAX, subscribe to their blog feed now.
0
Matt Smith
Top achievements
Rank 1
Rank 1
answered on 29 Mar 2013, 08:39 PM
Marin,
I would second that the documentation is WAY out of date. There are no class references for the AsyncUpload or Zip features. Without going really into depth, I would hazard to guess at least five or more of the "controls" do not have easily accessible documentations either online or within the MSHelp. It should be fairly simple to verify, just go to the help and try to find the class references to any ASP.NET ajax control you can put into the page.
It is really frustrating trying to implement something when expected behaviour of a property for the following control:
I would second that the documentation is WAY out of date. There are no class references for the AsyncUpload or Zip features. Without going really into depth, I would hazard to guess at least five or more of the "controls" do not have easily accessible documentations either online or within the MSHelp. It should be fairly simple to verify, just go to the help and try to find the class references to any ASP.NET ajax control you can put into the page.
It is really frustrating trying to implement something when expected behaviour of a property for the following control:
<TELERIK:RADASYNCUPLOAD ID="Pictures" RUNAT="server" MULTIPLEFILESELECTION="Automatic" INITIALFILEINPUTSCOUNT="3" MAXFILEINPUTSCOUNT="3" WIDTH="700" HIDEFILEINPUT="true" TEMPORARYFOLDER="~/app_data/uploads/" />
cannot be found in the documentation (in this case I only want to allow 3 files to be uploaded yet it is possible to select more than 3 and they will be uploaded upon exiting the file selection dialog). I know documenting a moving target is a never ending struggle. But at least there should be class documentation on all controls.
Cheers,
Matt.
0
Hello Matt,
Thank you very much for your feedback.
Indeed there are properties of the RadAsyncUpload control that are not yet documented. We will review the full documentation of the RadAsyncUpload control and include the most important properties. You also mention that there are other controls whose documentation does not seem to be complete. Can you please clarify the controls that you are referring to, so we can review them and update the documentation accordingly.
Regards,
Kate
the Telerik team
Thank you very much for your feedback.
Indeed there are properties of the RadAsyncUpload control that are not yet documented. We will review the full documentation of the RadAsyncUpload control and include the most important properties. You also mention that there are other controls whose documentation does not seem to be complete. Can you please clarify the controls that you are referring to, so we can review them and update the documentation accordingly.
Regards,
Kate
the Telerik team
If you want to get updates on new releases, tips and tricks and sneak peeks at our product labs directly from the developers working on the RadControls for ASP.NET AJAX, subscribe to their blog feed now.