• Alt.NET
• Architecture
• ASP.NET (more info about what sessions I hope to have in this track)
• Silverlight
• SharePoint
• Visual Studio
• Framework
• Tools
• Data
• SQL & BI
• Beginner
• IT
• Windows Phone

If one of these tracks is your area of expertise or you have a great interest in speaking at Philly Code Camp this year, please submit your topic here by going here:

http://codecamp.phillydotnet.org/2010-2/Lists/Speakers/AllItems.aspx

And clicking the “Add new item” button at the bottom of the page:

We look forward to your submissions.  Because with out you, the speaker, Code Camp doesn’t work.

We performed an analysis on xyz.com and found a great opportunity to increase your AdSense earnings. We recommend that you change your 120×600 ad units to 160×600′s on xyz.com. Here is an example of where we found this opportunity: xyz.com/

Generating the code for this new ad size should take no more than five minutes, and may have a substantial impact on your revenue. On average, publishers across our network who implement this change see a noticeable improvement on the CPMs and we think you’ll see similar results.

For an example of how small changes can make a big impact on your revenue, check out how CareerPlanner.com increased their revenue by 165% by making changes similar to the one I’ve suggested.

You’ll get the best results by updating all 120×600 units across your site. Our system analyzed 1pages across xyz.com and found 3 120×600 ad units.

And some of our new sponsors, we are welcoming this year to our family of partners:

And the charity we are sponsoring this time around is:

So if you would like to count yourself amongst these fabulous companies, please feel free to contact me to join our family of sponsors.  You can find the information about sponsoring Code Camp 2010.2 after the break.

Code Camp 2010.2

Saturday October 9^th 2010 from 8:30-5:00
Hosted at DeVry University in Fort Washington, PA

If you want to connect with the Philadelphia Area’s best Software Developers, DBA’s and IT Pros, here is your chance!

Philly.Net Code Camp gets better and better every year.  Here’s your chance to be a part of it!  Our past Code Camps averaged 500+ attendees, people working with Microsoft Technologies from Pennsylvania, New Jersey, Delaware, New York and beyond!  As usual, we are planning a wide variety of technology tracks including:

• Architecture
• Alt.Net
• Application Lifecycle Management
• ASP.Net/MVC
• Beginner
• Data
• Framework
• Mobile/Windows Phone
• Sharepoint
• Silverlight
• SQL Server
• Tools

What do the Sponsors/Partners Get?

1. Choice of tracks for Gold Partners are available on first come, first served basis.
2. Lunch break presentations are limited to 1-2 minutes per partner, just enough time to pitch your company and direct attendees to your table.

We Need Your Help!

Code Camp is free to attendees but expensive to run.  If you are looking for ways to connect with Philadelphia’s best Microsoft developers and professionals, this is the place to do it.  Our emails go out to our membership of about 4000 .Net Developers.  And of course, we partner with several other user groups, each with mailing lists of their own!
With your help, we’ll be able to provide the following:

• Breakfast – for about 525 people.
• Lunch – for about 525 people
• Snacks – Soda, Coffee, Snacks throughout the day
• Attendee gifts and Door Prizes – be creative.
• Presenter Prizes – The presenters deserve something too, don’t they?
• Session Prizes – In the past, each presenter was able to give out prizes during their session!
• End of the Day Raffles – After each Code Camp we give out a ton of prizes.  It’s a great way to end a great event.

What is Code Camp?

Code Camp is an event for Developers, DBA’s and IT Professionals working with Microsoft .Net, SQL Server and other related products.  We’ll have 60 sessions total (80 minutes each) in 12 tracks on a variety of topics including .Net, ASP.Net, SQL, Infrastructure and more.  Code Camp is completely organized by volunteers and all of the presenters are volunteers. Please check out our web site for information about Philly.Net, previous code camps, and this Code Camp (information will be posted shortly).
The following groups are assisting with Code Camp:

• Philly Alt.Net
• PSSUG (Philadelphia SQL Server User Group)
• Central Penn .Net

What is Philly.Net?

Philly.Net is a user group for Microsoft .Net programmers in the Philadelphia area. We’re a member of INETA, and have been hosting meetings in the Philadelphia suburbs since 2002. We also host meetings in southern NJ. In addition to our regular meetings, we have hosted several very successful code camps and hands-on training events.

Please contact me to discuss any ideas you have. Feel free to be creative.

My number one goal is to have every session packed full!

To accomplish this goal, this year I am going to put out a game plan that will focus on the intro and middle crowds.  I am going to lay out the game plan for the topics I want to see this Code Camp, and from those topics is what I am going to base the ASP.NET track’s speaking sessions on.  I am making this public so that everybody knows what I will be looking for and there is no confusion.  There is always flexibility in any game plan, but the general rule of thumb I am going to abide by is the following:

• No ASP.NET Web Forms, the technology just isn’t interesting anymore
• Nothing too focused, such as ASP.NET w/ X combined with Y technologies
• Hoping for a Non-Microsoft technologies session this year, as we had last year with Sara J Chipps, I am hoping for a Ruby On Rails person this time around
• Hoping for a entrepreneurship talk, about how to get your business rolling on the web
• Couple intro topics
• Couple mid-level topics
• And at least one what’s new topic
• Please no WebMatrix talks

Topics I will be looking for to satisfy the game plan:

1. Intro to MVC
2. Intro to jQuery
3. Intro to HTTP (seems weird but most web developers don’t understand HTTP or the difference between GET and POST)
4. Intro to Ruby On Rails
5. Transitioning from WebForms to MVC
6. What’s New In MVC 3 (w/ a Razor Overview)
7. Techniques to create a functional Web 2.0 site
8. The programmable web and how that fits in to your websites.  (Think effective use of REST)
9. Entrepreneurship and the web

So if you think you have an interesting talk, that falls in one of the above 9 topics or maybe one that I missed, and can make it to Code Camp this time around.  Please feel free to submit the topic to the Code Camp site.  I am always looking for new speakers to intro to the community, so don’t be afraid to submit the talk.

As a test I decided to look at the documentation posted online for five of the most common languages found out there today, that are tied to a specific company. 

• C# – Microsoft
• Java – Oracle
• Objective-C – Apple
• Ruby (Ruby On Rails) – 37signals (I know this is a framework, but this seems like the company with the most influence)
• PHP – The PHP Group

I needed to compare documentation on a somewhat equal footing, something that was going to be common across all the languages, so I settled on looking at the documentation for strings.  As I was doing this I found some very interesting dichotomies between the layouts and presentation used by each of the companies, some just didn’t care, others cared a great deal.  But the biggest factor was the usability of the documentation, some it looked like they simple wanted to present the information on the screen so they could say they have documentation, others cared very much about the UX, some look like they cared by like anything else a bad design seems to be weighing down their efforts.

Here are the five criteria I used to judge each set of documentations on a 0 to 5 scale.

1. Quality of documentation
   Does the documentation contain just the bare-essentials or does it contain helpful security, performance, and warning considerations that the developers should know about so they don’t run into too many gotcha’s too far down the line.
2. Ease of navigation
   This is important because if you cannot navigate the documentation easily and drill into exactly what you need to look up, it severely hoppers you productivity as a developer.
3. Code use examples
   Sometimes even if you have the API, the use of it isn’t exactly understood from the documentation alone, so examples of how the method should be used are always a welcomed addition for determining if you are on the right track or not.
4. Easy to read URL
   Having an easy to read URL is important, because not only does it help with things like SEO, since Google is always the first place I go when searching for documentation, it also helps in quick navigation of the documentation if you know exactly the class you are looking for.
5. Ease of switching between documentation versions
   Sometimes you queries in Google don’t exactly bring you to the right version of the documentation that you need, but if the site makes it easy to switch between versions then the right documentation is only a click away. Or on the other side of that coin, you cannot be using the latest and greatest in your job, but you still need to find relevant information to the version you are working with.

So lets get started.

PHP

The PHP documentation for strings was very poor, but I think that is because strings are considered to be a primitive in the PHP world, so all they could do was document other methods that interact with strings.  However, their over all documentation was poor and would have only received one out of five if it wasn’t for the excellent user contributed content and examples that each page has.  I don’t know if the excellent user contributed content was born out of necessity of bad documentation, part of the culture, or a combination of both but it seems to get the job done for the most part.  Besides the content the navigation was horrid, there is not an easy way besides search to find other relating documentation, besides drilling back up the navigation tree, and as far as I could see there wasn’t an easy way to switch to the different versions of PHP if you weren’t using the latest and greatest version.  And they seem to maintain this mid-90’s book paging documentation practice that allows you to continue to the next section of the documentation as if it was divided in to chapters, which really only reinforces the point that they haven’t looked at their UX for probably at least 10 years.  So that all contributed to the following scores:

• Documentation Quality (2/5)
• Navigation (1/5)
• Code Examples (3/5)
• Easy Url (4/5)
• Version Switching (0/5)
• Overall (2/5)

Ruby

Note: The documentation provided on Ruby On Rails seems to be a direct copy from Ruby Doc.

The documentation quality was very good, but on the same token very minimal it only gave you very terse information about each method, but the saving grace was definitely the code examples as far as the actual documentation went.  The navigation is very good for in-document jumping around, however it is very poor for browsing other classes in the Ruby language, on the other hand the URL’s seems to be cleanly represented and a power-user would be able to jump between documentation with easy by just using the URL.  Version switching was non-existent.  Which all resulted in the following scores.

Java

The documentation quality was very good, however after you get past the header of the document each method is only tersely documented and there were very few code examples or warning to base your decisions on. The UX as you might be able to tell hasn’t been updated probably since Java was released in 1995, their idea of navigation seems to be based on browser frames and one off targeted screens that just show a list of classes for instance in the namespace.  On the other hand the layout was simple, and a power-user could easily jump around the documentation with a few targeted clicks to find out more about the properties vs methods vs constructor.  The URL is very easy for a power-user to navigate through, because the classes and namespaces are right in the URL including the version, so it is everything you need to get right to the documentation you are looking for.  You can easily navigate to other version of the documentation by just changing the version in the URL, which isn’t ideal, but it is better than no method at all.  The only caveat is that the Java versioning isn’t consistent, but they seem to have redirects in place for common mistakes.  This all resulted in the following scores for the documentation:

Objective-C

The documentation quality is very good, and if I had to guess Apple took the structure of the Java documentation and just added the typical Apple flare to it.  Because most of the elements are laid out in the exact same order as the Java documentation right down to the navigation.  But a plus for Apple is that they got rid of the 90ish navigation techniques and added something a little more modern, but still not that great.  Instead of navigating the document by clicking links you select a drop down which will take you to the part of the documentation you are looking for.  In addition to that they have a nice menu on the right hand side that lets you jump around the class, but nothing more, so you can’t use it to browse the entire library.  One weird thing I encountered which I am still scratching my head at for the reasoning is the next button at the top of the page. It seems to take you just to the deprecated methods and then if you click it again takes you to the document update history, seems totally useless to me.  In addition there was no way to switch between versions and the URL structure was the most horrid I have seen, so that all resulted in the following scores:

C#

Lightweight

Classic

ScriptFree

I have to say that Microsoft is basically the cream of the crop as far as documentation goes.  They have 3 different views of the documentation depending on your needs and habits for browsing.  All 3 of the themes had a very clear UX that really shows that they care about how the developer perceives the documentation.  Because of the three themes the navigation varied slightly between them but all of them were very consistent in layout and approach, which made transitioning easy.  The URL is one of the easiest I have seen, because the structure is /{language}/library/{namespace}.aspx, which is very clear, easy to navigate, and short enough were you can easily tell where you are going before you click a link.  The code examples were top notch and most methods and properties had full code examples that you could copy and past and run right in Visual Studio.  In addition, they allowed community posting on the documentation like we found with PHP.  And Microsoft was the only company that offered switching of versions right in the documentation, even though it was only the Classic theme it was a very nice addition.  For the other themes you can switch versions with the URL.  Other welcome additions was the namespace navigation in the Classic theme and ability to drill out of the namespaces with the other themes and see all the peer classes in each namespace.  Overall I am very impressed by MSDN, which shows in the scores below:

Conclusion

As most of you know that have read my blog for any amount of time, I am a fan of C# as a programming language, and I always knew that MSDN had the best developer documentation.  But it wasn’t until going through this exercise that I realized how far ahead Microsoft is in having one of the best developer experiences around.

I am interested in hearing what you like and hate about each of these documentation sites, and any others you think warrant a mention.