Archive for June, 2008

Jun 25 2008

Profile Image of toebot
toebot

I’m not dead. I’m scouring TigerDirect for typos.

Filed under Rambling

Yeah, I know. How heroic. Actually, I was in the market for a Blu-ray drive for my PC and ran across:

Norazza DVDBR2PRO 4 Drive Blu-Ray Duplicator with 500GB HD

Norazza DVDBR2PRO 4 Drive Blu-Ray Duplicator with 500GB HD

I asked a sales representative about archiving Blu-ray discs and whether or not a standard DVD-ROM could at least “read” the Blu-ray data.  I was not entirely thrilled with the prospect of a $500+ internal Blu-ray drive.

As we carried on a moment about the typo and Blu-ray hardware we came upon the subject of the internal workings of why a DVD-ROM is not forward compatible with Blu-ray.

He said, “Anything is possible with software.  But you’d need a programmer to write that software for you as no such software exists like that.”

I chuckled.

As a side note, hopefully I will have something substantial up (famous last words) in a few days or so.

2 responses so far

Jun 10 2008

Profile Image of toebot
toebot

Do you understand what understanding means?

Filed under Rambling, Tip Of The Day

Take heed my small sampling of readers — when you read a tutorial for whatever purpose — make sure you completely understand it.

Often I read a tutorial on JavaScript or some advanced Photoshop tutorial and I am left thinking, “What the hell did I just read?”

I know it can be difficult because you may think, “Who do I ask when I do not understand?” The answer is not at all clear, but you can help yourself in a number of ways.

  • IRC – Yep, Internet Relay Chat.  You can search for channels (chat rooms) that contain listings such as “programming,” “javascript,” or even “love” — and find someone, somewhere who is willing to deal with your issues.

    Just make sure you obey the laws of netiquette and you should be fine.  In addition, make sure to obey the laws of the given medium.  If IRC, then how to behave on IRC.  If newsgroups, then how to behave on newsgroups, et cetera.

  • School
  • Internet
  • Socially accepted mediums – Twitter, Facebook, Slashdot, Digg, hell, even MySpace.

Woah, woah… the Internet?  Twitter?

What the hell am I talking about you say?

The thing is, that beyond the scope of the millions and millions of blog users out there — you have the “socially accepted mediums.”

These are the sites, chat rooms, blogs, forums, et cetera where like-minded people share and trade ideas, wisdom, and other semi-useful information.

Twitter for example exclaims, “What are you doing?”  Well, I am currently writing this post.  However, it means what are you doing (for the day)!?  Are you studying?  Skiing?  Flirting?

Does it not make sense to ask others who are doing the same thing as you for their opinion?

Seriously.  Whether it is a StumbleUpon’d site or someone who happens to share a few of the same interests as you, it is always wise to let others know that you value their opinion and have a desire to digest the information that only they (or someone just like them) can provide.

Did the Internet response floor you?  Why!?

How many times a day do you Google information?  How many times a day do you fire up a browser just to look up a reference at Mozilla or Microsoft?  How many times a day do you review DevGuru’s CSS reference?  How often do you visit Programmer’s Heaven?

Um… hello!?  That is the Internet!  Every time you seek information that is not included in a software program’s help resource or visit a “reference” site, you are referring to the Internet.

Trust in it, just do not be led astray by it.  Much like Wikipedia.  I do not give two cents for what others think — Wikipedia is an excellent resource!  However, you need to be smart enough to discern the multitudes of shite from the grade “A” fertilizer.

No responses yet

Jun 02 2008

Profile Image of toebot
toebot

Tip of the Day: Learn an API documentation syntax.

If you write programs or “code applications,” then you should seriously check into the standard commenting and API documentation syntax available to that language.

This has 2 primary benefits, possible others:

  1. You learn to properly comment your code.
  2. Your code explains itself to other programmers.

And anything that increases your efficiency and aptitude in something you enjoy either as a hobbyist or as a professional can only result in positive learning — the best kind.

Wikipedia’s comparison of documentation generators can be found here. This lists the majority of those I could possibly think to show you, so make sure to research the language you code with.

These tools generate API documentation based on your properly formatted comments.

The ones I keep in mind are:

Otherwise, I have not used any others, but I have heard that:

  • Doc-O-Matic
  • ROBODoc
  • TwinText
  • Universal Report

Are the most robust.  And the article I provided earlier illustrates that same assumption.

I believe I saved the best for last, and that is Doxygen.  As far as I know, Doxygen can automatically generate well-formatted API documentation for several languages and is by far the most robust*.  If it currently had deep support for JavaScript and/or ASM (assembler or assembly) I would tentatively call it the ultimate and only tool necessary.

* Please let me know if there is a more robust or preferred tool — either by industry or by popularity.

No responses yet

Jun 02 2008

Profile Image of toebot
toebot

Respect browsers other than your own!

Filed under Functionality, Usability

Number one thing to remember when presenting your site to the world is not everyone has the same browser as you. More importantly, not everyone has the same amount of RAM or processor speed that you have.

Whether a site is usable or not goes far beyond a site “worked” for you in Browser A.

I visited a blog today that loaded 50+ two- and three-page articles on the main page. So, a word to the wise, well, and to the blog users *wink* &mash; configure your blog or CMS to deliver a specific number of results per page — something like less than ten is ideal. Unless of course your posts are several pages deep, then you might consider an even smaller amount.

This goes equally for archives. Just because I want to see all 1,000+ of your < insert topic > articles, does not mean I want to see them all on one page.

No responses yet