Reflections on the Yapcom Development and Usability

[prev] [thread] [next] [lurker] [Date index for 2004/06/06]

From: Shlomi Fish
Subject: Reflections on the Yapcom Development and Usability
Date: 17:30 on 06 Jun 2004
Hi!

Well, YAPC::Israel::2004 is over, and Yapcom was mostly up to the task. 
Nevertheless, I think it has several standing issues, which I suggest be 
cleaned up beforehand. I'd also like to reflect on my attempt to contribute 
to it.

I tried to contribute to the Yapcom development, and some of my contributions 
or suggestions were eventually accepted. However, many times when I tried to 
contribute, I got stuck because I was not able to write a suitable test to 
fix a certain issue. Sometimes, it happened because Yapcom expected a 
different configuration than what was currently present, and from what I was 
told this behaviour was hard-coded there and not modifiable by the tests. I 
suggest we make sure the tests are able to set this or mock it in some other 
way.

Other than that, another standing issue was that the Yapcom configuration file 
contained a lot of things that could be learned from the environment 
variables supplied by the web-server. This creates a duplicity of 
configuration, which would make it harder to install and upgrade it.

The Apache configuration was also an issue. It was somewhat complex, and 
perhaps could be specified.

A final minor issue was the fact that our executable was named "2004". This 
was because it was argued that people may not be able to alias the URL on the 
web-server. I suggest we rename it to yapcom.pl instead. People who download 
the distro some time into the future would be annoyed by a "2004" filename. 
In any case they can use "/conferences/2004/yapcom.pl/" which is a bit ugly,
but still usable. And we usually can assume they can configure their 
web-server accordingly.

Yapcom reminded me a bit of all these web-applications you can download from 
the Net, that require to set up a lot of things and to configure them before 
they are ready. This is as opposed to some web-applications which are 
surprisingly easy to set up - just run a script on the directory or unpack
a tarball, change permissions and then enter a URL on the web-server. We 
should aim that Yapcom be as close to the latter as possible.

Hopefully, these issues will be resolved in the hacking activity before the 
next conference. But we may want to resolve these problems now, so we'll have 
less work later.

Regards,

	Shlomi Fish
-- 

---------------------------------------------------------------------
Shlomi Fish      shlomif@xxxx.xxx.xx
Homepage:        http://shlomif.il.eu.org/

Quidquid latine dictum sit, altum viditur.
        [Whatever is said in Latin sounds profound.]

Generated at 10:20 on 16 Jun 2004 by mariachi 0.52