On May 14, 2010, at 12:05 PM, Jens Alfke wrote: > Oh, also, a comment on the site design: why do you present source code in the > form of screenshots of Xcode windows? This makes it impossible for a user to > copy the text easily, for a blind user to read it at all, or for a search > engine to index it. It also consumes orders of more bandwidth (for you and > the viewer) than just the plain text would. > > —Jens
> Oh, also, a comment on the site design: why do you present source code in the > form of screenshots of Xcode windows? ( 1 ) I frequently make circles, boxes, and arrows around some of the code images. ( 2 ) All the colors are accentuated, and the user sees exactly what I see. ( 3 ) In order to show the source code (exactly as the screen captures show) using HTML would require so much more work for me, that I would just quit doing these little tutorials altogether. I know that most people on these forums know a whole lot more than me, and that's OK, but most most of them don't have the time to create tutorials, so hopefully there will be some people that can benefit from the incredible amount of time it takes to figure out some of this stuff. This Cocoa stuff is geared for the beginner like myself, obviously not for the experts on this forum. > This makes it impossible for a user to copy the text easily, for a blind user > to read it at all, or for a search engine to index it. I agree with what you are saying, but I include the xcode projects for the user to download. This way they can make sure that the projects work as expected. I have spent so much time reading text tutorials, that after I copy and paste, etc. will not run at all, and when you try to write to the author, they do not respond. > It also consumes orders of more bandwidth (for you and the viewer) than just > the plain text would. Because I am not a good writer, I prefer to have more images with minimal text. That is my preferred style. On my home page at http://www.journey-of-flight.com , I have the following at the top of the page : ------------------ NOTE : I got some feedback from someone with a low speed connection : "If you don't have a high speed connection, you may want to avoid my site. All the tutorials have a lot of images which might load slow otherwise. I tend to forget that I am extremely fortunate to have (20/5) MBit Business FIOS service at home, so for me they load lightning quick, but please be aware of the loading time if you do have a slow connection." If you have suggestions, or comments, that's fine, but try to keep them polite... ------------------ We all have different styles, and it is tough to please everybody. A couple of times I thought I would close down the website, or at least remove the Cocoa stuff, because I would post the tutorials on some of the boards and ask for feedback, and I can count on one hand the few times anyone said anything, positive or negative. I got a really nasty note from some guy that hated the font I used. Go figure ? Then yesterday out of the clear blue sky, I got the following, and I was floored that someone appreciated the work : ------------------ From: [email protected] Subject: Saw some of your work on your website... (and it rocks) Date: May 13, 2010 12:58:14 PM CDT To: Bill Hernandez <[email protected]> Hey Bill, I just wanted to reach out and thank you for all of your absolutely fantastic Xcode tutorials with relation to Obj-C and Interface Builder. I had been a long time AppleScript Studio user (then had to move over to Windows programming for a few years) and I recently had to come back over to the Mac to work on a project. Of course upon arrival, I was shocked to see ASS had been replaced with AppleScriptObjC. Thus began my (rather short) journey into learning it and after about 90 minutes of quite a few "why wouldn't I just use Obj-C but I don't know it" fears, I came across your site and all my doubts about being able to use it went right away. I am a pretty experienced C# guy and I was actually pleasantly surprised to see how easy it was to make the connection between the two. Your IB tutorials helped fill the gaps (amazed at how easy it really is) and I am on my way. I'll also be picking up some of your recommended books but overall I have you to thank for really connecting the dots and pointing my in the right direction. So thanks again Bill. Truly, truly appreciate your site!! Scott ------------------ Anyway Jens, thanks for the feedback. I'll think about what you said... Best Regards, Bill Hernandez Plano, Texas http://www.journey-of-flight.com _______________________________________________ Cocoa-dev mailing list ([email protected]) Please do not post admin requests or moderator comments to the list. Contact the moderators at cocoa-dev-admins(at)lists.apple.com Help/Unsubscribe/Update your Subscription: http://lists.apple.com/mailman/options/cocoa-dev/archive%40mail-archive.com This email sent to [email protected]
