Aside from my studies and part-time job, I’m partaking in the activities of Cybernetisk Selskab [no], a student driven association working to improve the social environment at the Department of Informatics. As a member of the board, I’m frequently involved in the different activities arranged, and one of them is the CybWebDev.
Currently we’re focused on Aurora, the codename for a system which aims to be an array of tools supporting the organizational work in CYB. This, we believe, will be especially important when Escape opens, the student driven pub that will open along with the opening of Ole Johan Dahls Hus [no], the newest addition of buildings at the University of Oslo, which will be the base of most of the educational, academic and social activities concerning the students of computer science.
In doing the preparations for this development, we’ve discussed some principles/guidelines that we wish to follow when designing/coding, and I thought I would share them with you here.
Don’t reinvent the wheel
We will use a framework, namely Django for our project. Although this will be just another CMS, we hope that Django will speed up our development, powering documentation and a user base that can help us in our hours of need.
Personally, I’ve tried building a system from scratch several times, only to submerge myself in bugs never-ending, unexpected quirks taking hours figuring out and finally just installing a CMS that gave me all I needed.
Follow the W3C-standard
We wish to adhere the foundation laid out by the W3C. This means coding following their guidelines, validating using their tools, and ignoring how its rendered in the different browsers. We believe this system should stand the test of time, and we believe this can be done by following the W3C’s standards.
This means that we will not spend time adjusting our code so that those who use IE6 – or other outdated browsers – will be able to get a topnotch experience using our systems.
Write good markup
By good we mean semantically correct, not cluttering it with unnecessary tags. It’s more or less a continuation of the former point.
This choice means that we will strive to build functionality from bottom-up, rather than top-down (that is, graceful degradation). If we cannot build a baseline functionality for a certain problem, than we must either research more into how we can solve the problem, or we’ll drop the functionality.
Before anything else, we will design for the traditional computer screen-experience. But we believe HTML to be such a powerful tool, that it can ported to mobile clients quite easily. Writings on Responsive design1, 2 has inspired us to give it a try, to apply certain rules for handheld devices sporting smaller screens than the standard computer screen.
Write descriptive code
Writing documentation is a drag, period. As students doing this on a voluntarily basis, we don’t wish to spend hours upon hours writing documentation. Rather, we will write descriptive code, that is (hopefully) easily understood by other programmers. We will also strive to follow the guidelines of the framework, which will help us in future decisions-takings.
Although we have good experiences with TDD, we do feel that writing test hampers the process. We want the process to be flexible and smooth, and we do not feel that writing tests supports this feature. We also feel that the systems we produce won’t be so complex that it will be difficult to debug when bugs arises.
As a side-project in a student driven organization, we realize that our code will not survive the next generation of coders if they can’t understand what we’ve done. In extension of this, we must consider that when code becomes complex, we must stop and rethink our progress.
Iteration, iteration, iteration!
We do not know all the answers upfront. The principles/guidelines described here may be wrong at certain times, and we must be flexible to those needs. In fact, I’m quite eager to find out whether or not they will stand the test of our development. Time will tell.
Not to forget, the project should be able to nurture our curiosity and provide fun in our development for the web. If this fails, all will fail. I believe the group will have lots of fun in this project, and I’m looking forward to contributing to it.