SharePoint can take you to Disney!
And also to the Microsoft SharePoint Conference in Anaheim, California from October 3 to 6, 2011.
Reference Documentation
In the November edition of MSDN Magazine, Peter Gruenbaum explains how to write good reference documentation for APIs in his article titled “A Coder’s Guide to Writing API Documentation”.
My attention was particularly drawn to Figures 2 and 3, which explain how to comment while maintaining consistency throughout the API. I have reproduced them here:
Figure 2: Reference Documentation Style
| Type | Guideline | Examples |
|---|---|---|
| Class | Start with a word like “Represents” | “Represents a user’s photo album.” |
| Methods and functions | Start with a verb | “Returns the number of contacts for the specified area.” “Pauses the video.” |
| Properties | Use a noun or start with verbs such as “Gets” or “Gets and sets” | “The user’s tasks.” “Gets and sets a collection of the user’s tasks.” |
| Events | Start with a phrase such as “Raised when” or “Occurs when” | “Raised when the response from server is received.” |
| XML elements | Use a noun-based phrase | “The city’s postal code.” |
| Boolean values | For Boolean properties, start with “Indicates whether”; for Boolean return values on methods and functions, start with “Returns whether” | “Indicates whether the control is visible.” “Returns whether two regions intersect.” |
Figure 3: Reference Documentation Example
[Read More]Visual Studio 2010 Wallpapers Background
If you want to show off your VS2010 love, then the VS2010WallPapers (not affiliated with Microsoft) site is perfect for you. It allow you to select from dozens of concepts!
French Book on C#
For those who struggle with the language of Shakespeare, Gilles Tourreau (another MVP) has recently released a book on C# in French! And God knows how rare French technical books are!
Back from Nepal
After 4 weeks of vacation, I am now back home. It must be said that it is not necessarily a restful vacation to go to the other side of the world and reach the foot of the highest peak in the world!
4 weeks without contact with a computer (ok ok, 2 minutes to say that we were still alive), it feels rather strange! And did you know that all along the climb to the Everest base camp they have installed cell towers? So it’s not surprising to come across a Sherpa in full conversation with his mobile phone!
[Read More][VS2010 Tips] Multi-line Insertion
While reading the MSDN article on converting VBA applications to C# 4.0, I remembered the famous ALT+[Selection] function that allows you to insert the same text/code on multiple lines at once. So, here is the English version of that part of the article:
Press ALT and select where you want to insert your code (selection in light blue in the image below):
Type your code and boom! All the selected lines have been filled with your code:
ASP.Net: How to Exploit the Vulnerability
As I previously highlighted, an ASP.Net vulnerability can be exploited by malicious individuals. Here is a demo exploiting it on the DotNetNuke platform.
48 Free Microsoft Applications
I just came across an article from Tech Radar offering 48 free applications from Microsoft that are often little known. Such as Expression Encoder and Windows Steady State!
Important: ASP.Net Security Vulnerability!
For all those who have ASP.Net sites, all versions included, please pay special attention to this security issue: details on this entry from ScottGu.
Free eBook: Moving to Microsoft Visual Studio 2010
Thanks to Éric for publishing the news. A free book of over 300 pages, it’s not every day you get that!
