On Mon, Jul 25, 2011 at 05:53:17AM -0400, Chris Lalancette wrote:
On 07/24/11 - 02:44:33PM, Hugh Brock wrote:
> * Documentation
> * I'd like to see the community get into the habit of creating or
> updating wiki how-to pages as we go along. I'm not sure exactly
> how to promote this (free beer once a month to the best new
> page?), but I am fairly sure we do need to make the infrastructure
> a little easier to deal with for it. Like it would be good if the
> wiki didn't become unreachable a lot, the way the Redmine wiki
> seems to do.
Yes, and merging the two wikis into one would help too :).
You know, I'm hesitant to suggest that a third wiki will solve our
I'm really liking Github's wiki system. To Hugh's requirement, it
doesn't go down all the time. It also supports multiple markup formats,
so people can write in whatever is most natural to them. (As trivial as
this sounds, we want to make it easy.) We could migrate content over
from both wikis to avoid the obvious problem of having three wikis.
Of course, the obvious downside is that not all of our projects are
using Github, so it might be a little odd to have documentation kept on
an external site.
> * Way better logging and error reporting.
> * All components should be using syslog if at all possible
I don't know that I agree here. Why would I want all of my logs dumped into
the same bucket, where it is difficult to tease them apart? I kind of like the
per-daemon logging, as it is easy to debug the piece you care about. Maybe
what we should have is an aggregation tool, or sos plugin, that will gather all
of the stuff together from somebody when we need to debug multiple components.
I really don't like the idea of inventing our own log aggregator,
because we end up re-inventing the wheel. You can configure syslog to
write log files per-daemon if you want, but they'll all be in /var/log,
as opposed to having some things randomly writing to
There are also a few gems that make it easy to get Rails itself to write
to syslog if desired.