Hello and welcome to another session of why do I document code. Today's contestants are:
1. The Software Requirements Document otherwise known as the SRD - This valuable little document tells the developer what to develop. Is was started by the Carnegie Mellon. It is used as a contract document between the developers and the customer. The customer starts the document by what they expect the program to do. Everyone knows that the customer always changes their mind, well if you use the SRD, they are held by a legally binding contract that specifically states what to develop. You as a developer don't develop anything else except for what this document states. Therefore if the customer changes their minds, well you can either point back to the SRD or decide to charge them more money.
2. The Database Maintenance Manual otherwise known as the DMM - This handy dandy contestant describes every little feature about your applications database. IT describes the tables, the columns, the attributes of the columns, the generated script of the entire database, the user logins, the ways too install and upgrade the database on another machine, the DTS and last but not lease etc... This basic manual describes in detail every single part of the database. The reason for this is if you had a total hardware melt down and nothing works, well you now have a copy of the database that can be recreated using the script that was generated and put inside the file.
3. The Software Design Document also known as the SDD - This massive document describes all the methods, namespaces and functionality of the Code. IT also describes the developers thoughts and opinions to why they code the application one way compared to another. When I say everything, I mean everything. This document has all the developers thoughts and opinions when they were designing and developing the code. Thank god most comments can be extracted via an XML parser. The XML parsed comments can even put it into a nice little help file just like MSDN.com. Where can you learn how to write one, well let me tell you. Our good friends(Not really at all) at Bit Formation has made a great tutorial on how to write one.
4. The User Guide - The user guide plain and simple is the thing users use to get around the application. Every little thing that was EVER created by man has some sort of user guide attached to it. These are a no-brainer, but long and tedious to write just like the other documents listed here today!
Now that you know our contestants, lets find out why you would do such a thing.
Alright, enough with the game show. I thought it would be a good starter. I completely agree that all the documents though rather tedious and considered a time waster by developers is a necessary part of life. Developers need to both COMMMENT CODE and write documentation. That is the way it should be and should end up. Documents are there in case you as the developer get into some kind of horrific accident and are no longer able to continue on. They must find someone else to keep going. Sorry, but that's the way life is. You are writing the documentation incase you have to be replaced. I currently work on a 20 year application and I know for a fact that I will not be working on this same application for another 20 years. I just won't do it. It is too boring and mundane. I do know that some day, they will hire another guy or girl who will have to continue my work and when that day comes, the documents are there.
Ladies and gents, just think of documents as another day in the life of a developer. Things must be documented.
I was surfing the Internet the other day and found a Video about how Firefighters who are getting fired because they don't speak Spanish. Crew captains are required in some states if not all states to be able to speak their firefighters languages. Is this a definition of freedom. Can any one person be allowed to speak a different language on freedom of rights. I think so. I think this is allowed to happen because it is his right to be free and therefore his right to speak what ever language he wishes. As for should he speak English in America? Well due to the fact that America has no National Language, yes he does have the right to speak Spanish in America. Should others get fired because he decides to speak Spanish and not English? No, that is discrimination and against the law. It is against the Law to discriminated against because once again every man is free in our country. Could it be taken to the Supreme Court? Yes, it can and should be taken to the courts for their judgement. It could even in fact start a national movement or law for the requirement of an English Language.
The basics of this country is that EVERY man is FREE. Not just Americans. We are built on these basic principals. Someone might argue that they came to our country, they need to learn English. If they learn English, then we will be forcing a person against his freedoms this country provides him to learn something he doesn't want to. The only forcing that should be done is to force a person who has committed a crime. If a person harms another person in anyway, they have just given up their rights to be free. This now allows for a person in this country to be forced to do something, but until that happens their freedoms should not be taken from them.
My personal opinion? When a cop decides to pull over a person who is not fluent in English, but has a legal drivers license for the state he was driving in because the DMV deems in necessary to put Spanish up on the screens for driving tests instead of English. This I think is a safety issue and should require either the driver to be fluent in English or Americans in general to be fluent in both languages. I guess we will see what happens in the next couple of years. I for one hope that English will be nationalized, but it is not the right of a free man to be forced to learn a new language.
So, I am creating a web application over at www.utopiapimp.com , and I am completely renovating the app and converting it from PHP to ASP.net. Its a huge job but I decided to take it up. Thought it would be fun. heh.
Today I got there error:
An error has occurred while establishing a connection to the server. When connecting to SQL Server 2005, this failure may be caused by the fact that under the default settings SQL Server does not allow remote connections. (provider: Named Pipes Provider, error: 40 - Could not open a connection to SQL Server)
I found a workaround and wanted to post it really quick.
Step 1 - You gotta produce the error!
Step 2 - Go to Start -> Microsoft SQL Server 2005 -> Configuration Tools -> SQL Server Surface Area Configuration.
Step 3 - Go to Remote connection under Database Engine
Step 4 - Click on Local and Remote Connections. Allows the testing group to connect.
Step 5 - Now, you have to stop and start SQL Server for the changes to take affect, so go back to Service Tab and press Stop and then Start.
Bush just defended your right to free speech over the air ways. President Bush assured members of the National Religous Broadcasters (NRB) that he would NOT let congress take away freedoms over the airways. Democrats have threatened the rights of Free Speech by wishing to reinstate the Fairness Doctrine.
The Fairness Doctrine - Limits the breadth of Free Speech and public debate by forcing airwaves to present both sides of an argument.
By doing this, they are taking away your rights as a citizen, as a FREE person and as a human being. The Founders of this country where so ingenious to allow the right for every person to be free. I ask that you look over this.
You have been informed.
A few days ago, I read and article about a 15 year old girl who saves 40 elementary school kids while riding on a bus and then gets suspended. Here is the article. The high school girl got on the bus in the morning and didn't get off at school because she asked the bus driver to take her back home because she felt sick. The bus driver gave her consent and decided to take her home after dropping off the elementary school kids. While driving to school it says the driver bumped their head and was un-conscious. The 15 year old girl then got up out of her seat and applied the breaks after the bus had already hit two cars. The school deemed that she should be put into Saturday school which lasts over 5 hours on her Saturday. I guess I am saying what kind of messed up school is this? The principal has the authority to to override this detention and they didn't. I wonder if they even gave her a medal or a medallion for saving 40 elementary school kids from a freak accident!
I thought this 15 year old is very much inspiring. In today's world, you don't hear much about hero's. You only hear about violent crimes and criminals, the news doesn't cover the good deeds because they only cover the bad deeds. I think and I imagine every other person that reads this and the families of those 40 kids are extremely thankful for what she did.
I grew up watching Michael Jordan play ball and watching Super Man always believing he was real. I saw plenty of heroes in my day as a kid. Today though, I don't see many heroes in this world as there should be or a person would hope there would. I just hope those 40 elementary school kids still find heroes in today's society. I am a bit older without kids, so I don't know what kind of heroes kids have, I just hope they are out there. As for the 15 year old, I think she will be my hero and inspiration for at least a week.
For something that has not been in the news, Google and TiVo just joined up to launch YouTube video viewing on TiVo boxes by year end. YouTube videos are watched about 66,000,000 times a month and now you will be able to watch it at home if you have a broadband connection and a TiVo Series 3 box. Just imagine the advertising revenues Google will bring in for YouTube that has YET to produce significant profits. Everyone in the country has a TV, not everyone has a computer. Google is just satisfying their over all goal, which is to organize the worlds information. Just imagine, no more TV programs and large TV companies that demand a specific amount of commercials. These companies have already started to post their shows online the day after it airs, just imagine the shows now straight to your TV instead of Illegally downloading them on things like Torrents.
I saw the visits to the site go crazy when I posted 16 rules to live by. I also know I wasn't too detailed when I talked about Randy Pausch and the things I brought away from his video. So here I am doing my interpretive dance of what I feel are 8 more values/rules you should think about.
1. Decide if your a tigger or Eeyore.
This is just about having fun. If your a Tigger, then your just having fun every day. That's it. You have to decide wether your a Tigger or an Eeyore. I would consider my self a Tigger.
2. Never lose the child like wonder.
Never lose your childhood fun and excitement. Always be a kid at heart. Its just too important, this child inside everyone is what drives us to have fun and succeed. Keep up with the kid inside of you and your life will be more joyful every day.
3. Help others.
There would be peace in the world if everyone helped one another. Teach someone by example. Volunteer and do something that excites you in helping people. Go to a homeless shelter. Donate your things to Goodwill. The world would be a better place if everyone just passed it on and helped other people.
4. (For the Ladies) He says this is one of the greatest quotes he has ever heard, "When it comes to men that are romantically interested in you, just stop listening to what they say and watch what they do."
One of those lessons that can be used in every woman situations.
5. Tell the Truth
Just one of those that every man of every faith should do.
6. Be Earnest.
People will take a Earnest person over a hip person any day.
7. Apologize when you screw up.
People will not only respect you more, but will still give you things they can trust you with.
8. Focus on others and not your self.
This will make you more of a humble person.
9. Never Give up.
Don't stop at what your doing. Accomplish your dreams. Finish what you started.
So I read an article today about Kevin Ham. Anybody heard of him? This man has not only been named "The man who own's the Internet", but also beats out Internet Moguls like John Chow. Kevin, built a 300 million dollar empire over night. On what you say? Buying up Internet domain names and throwing advertisements on each site he bought. Why does this idea make me not only upset, but Furious? Well, first it was a GREAT idea to buy up the domains. Hah, I wish I though of it first. Why does it make me mad? Well, because when I go searching for a new domain name to add and actually put content on, He already owns them! I honestly wish the United States would call this a monopoly on domain names and force him to let go of most of them. The Internet is free and I would rather like to see great content out on 300,000 domain names than advertisements. It would make the world a better place, I think.
I actually wonder if the politicians know about this at all? Well, it just disappoints me that content can't be put on sites like these, but It does say at the end of the article that Kevin plans on putting content on the sites, but how long and what kind of content would he actually decide to put on the sites. That also brings on another thought, if he does not like the content then he can be a dictator as such and have it removed. This I think is a form of obstructing free speech.
I recently had to setup all my new blogs on GoDaddy this past weekend and it was a pain! Let me tell you what, I would hope that others find this post so they don't have to go through the same thing. I found a old post with not up to date information on setting it up. So here is the up to date version as of 3/12/08 and GoDaddy Hosting Control Center V2.5.0.
1. Go to http://www.dotnetblogengine.net and go download the entire source located here.
2. Remove the following line from web.config. This is due to Godaddy has medium trust set on the site.
<!--<trust level="Medium" />-->
3. Publish the site using any sort of FTP upload client or even Visual Studio. I would not compile the website. Let the website compile it self on GoDaddy.
4. Open up GoDaddy and the Site Configuration manager.
5. Go to the File Manager.
6. Check Mark the App_Data folder and then click the permissions button as circled below.
7. Set the access to Read, Write and Reset all children to inherit. This will allow all files under it to inherit the above settings. This allows you to move files in and out of App_Data folder and not having to keep updating the permissions in GoDaddy.
8. Click okay and then move on over to IIS Settings.
9. Create a Folder called App_Data. Before you complete the next step, let me advise you that BlogEngine did not say to do this, but I found it to be the only way to get BlogEngine to work. So now Click on the Advance button. Click the Classic Settings. From here it will take a few hours to set up and if the admin's are really good, it will be done in about 30 minutes.
10. Happy Blogging!
Ghalib Ali Hamid, a top Iraqi official at the Bayji refinery, is suspected of skimming profits and having ties to insurgents. (Eros Hoagland for The New York Times)
Everywhere around us, there is corruption, death and destruction of the human race. I started this blog to have an idea of why people would want to stop a thing as great as liberty. Why would people want to snuff out freedoms. Why would people want to kill others. Can't everyone live in peace. I know peace is a long shot and would require something out of Star Trek - First Contact where aliens come to Earth and Unite the entire human race. But, today is not a day like any other day. Today and most likely for a while now the troops have known about Profits from stolen oil that helps sustain the insurgency (bad guys) in Iraq. The profits are skimmed about 1/3 off the top and given to the insurgents. This is upsetting in many ways. Why? Well let me tell you, some people say that we entered the war in Iraq for Oil and now it shows that oil is working against us to kill soldiers and innocent civilians of Iraq. This is extremely sad and disheartening. I don't wish death upon anyone, but for someone who kills for the ability to rule with an iron fist, I say the hell with them. I feel that we went to war in Iraq, not just because of the WMD that were supposed to be there, but because of the atrocities that were happening at this day and age.
1980-88: Iran-Iraq war left 150,000 to 340,000 Iraqis and 450,000 to 730,000 Iranians dead.
1983-1988: Documented chemical attacks by Iraqi regime caused some 30,000 Iraqi and Iranian deaths.
1988: Chemical attack on Kurdish village of Halabja killed approximately 5,000 people.
1987-1988: Iraqi regime used chemical agents in attacks against at least 40 Kurdish villages.
1990-91: 1,000 Kuwaitis were killed in Iraqi invasion of Kuwait.
1991: Bloody suppression of Kurdish and Shi'a uprisings in northern and southern Iraq killed at least 30,000 to 60,000. At least 2,000 Kurdish villages were destroyed during the campaign of terror.
2001: Amnesty International report: "Victims of torture in Iraq are subjected to a wide range of forms of torture, including the gouging out of eyes, severe beatings and electric shocks... some victims have died as a result and many have been left with permanent physical and psychological damage."
Human Rights Watch: Saddam's 1987-1988 campaign of terror against the Kurds killed at least 50,000 and possibly as many as 100,000 Kurds.
Refugees International: "Oppressive government policies have led to the internal displacement of 900,000 Iraqis."
Iraq's 13 million Shiite Muslims, the majority of Iraq's population of approximately 22 million, faced severe restrictions on their religious practice.
FBI: Iraqi government was involved in a plot to assassinate former President George Bush during his April 14-16, 1993, visit to Kuwait.
The Iraqi regime has repeatedly refused visits by human rights monitors.
Now, don't get me wrong, there are other bad things going on in this world like Darfur, Myanmar, China and Burma. The problem that we had with Iraq is that they were able to move it to a global scale if necessary. The other countries are only in the certain regions. They do not threaten the world population as of yet. Iraq did and its neighbors still do. I truly wish that when we were done with Iraq, we would push the spread of democracy and Freedom. I wish that we would support financially other countries and groups of protesters that wanted democracy. I imagine we do and it is not publicized, but I could only wish that the US government is pushing for democracy and liberties all around the world.
I thought of a quote that would fit right along with this. "Every person has the right to be free, no one person deserves to be a slave." I believe that down to my bones. I hope you do too.