Ubuntu’s Hoary Hedgehog release; Mutual obligation

Ubuntu’s Hoary Hedgehog release

I upgraded from the stable Ubuntu to the development version (due to be released in April as, I believe, 5.04) on the weekend. So far I haven’t actually noticed very many dramatic changes. Booting is marginally faster. There are now suspend scripts that don’t work (well, for me, there’s positive feedback about them in general). The default fonts look different. Otherwise everything seems pretty much the same.

One thing I was reminded of, particularly when upgrading my workstation which has such a slow disk that the UML server that runs puzzling.org can install packages faster, is that desktop Ubuntu systems have all the Python development libraries installed. It’s nice that they’re all supported, but I’ve developed using Python as a primary language for four years or so and I’ve still used only five of those libraries (more once Twisted splits into packages…). I’d be happy to install them as needed, just like I would gcc.

Mutual obligation

Alignments of the stars this week have me going to a meeting at SLUG on Friday to try and organise a community program that tries to get local volunteers together to work on Free Software. Why add this layer between local volunteers and Free Software, given that most projects have open development communities?

Well, there are a couple of reasons. The first is that to receive unemployment benefits in Australia you need to fulfil a ‘mutual obligation’ requirement in which you seek work, train or give back to the community. Setting up a local community group/non-profit will allow people on the Newstart allowance to work on Free Software (and docs and bug triage and mailing lists and…) as part of their mutual obligation. The second is that there is a group of somewhat nebulous size who would ‘love to help out’ but aren’t for whatever reason suited to jumping into new communities and offering their work up. Having a group set up to specifically push them into projects may help here: it will be interesting to see.

This is something that’s been in the background of my thoughts for years now: working with people who aren’t used to the standard model where you just start doing stuff; or the other standard model where you hang out on IRC for a few months until people know you’re not an idiot, and then you start doing stuff. This third group is the set who ‘need an invitation’, if you like.

Clarification re Ubuntu and compilers

Some questions imply that I wasn’t terribly clear about this, so now I will be clear: Ubuntu has supported binary gcc and g++ packages. You can install them via apt-get/aptitude/synaptic. (By the way, on Debian systems I use aptitude now because it especially marks "packages that were only installed because I installed another package that depends on it" and automatically removes them when nothing depends on them any more. Even better than deborphan.) It’s probably easier to grab the build-essential package though, which drags in those and make and a few other things as dependencies.

The ‘problem’ with the compiler is not that it is not packaged and supported, it’s just that if you whack a CD in your machine, choose the default install, and then log into your brand new Ubuntu machine, you will find that the compiler is not yet installed.

This is not something I personally consider a problem, possibly because I’m a Debian user and also because while I have tried the RPM distros I came to them rather late anyway (RH8) when apt-get like tools (yum, apt for rpm) were not far away. I’m very used to the idea that software that’s not installed yet is just sitting in an archive or on the CD somewhere for me waiting for me to use a nifty tool to download and install the package. (As for satisfying dependencies of packages, my automatic reaction on any distro whatsoever now is "what’s the apt-get equivalent on this one?" It pretty much always has an answer now too.)

It appears though that some people don’t think this way. They think "either it’s on the computer at the end of the install or it’s a major disaster involving downloading the packages myself and resolving the dependencies by hand or it’s a super-major disaster involving downloading the gcc source and trying to bootstrap a gcc compile." They don’t imagine this fourth option where it’s not on the computer yet, but hey, it’s just there on the CD waiting for me to type "aptitude install gcc". (Actually, there are people who do realise this and just hate the idea, but the entry wasn’t about them.)

And these users are not a good fit for this particular design decision of Ubuntu’s. Which is a pity actually, because I thought it was rather a good one myself.

Python in Sydney; Ubuntu among the Python programmers

Python in Sydney

Alan Green organised a Sydney Python Meetup last week. I’m pleased someone stepped into this slot: I was organising Python meetings a few years ago, ran out of energy during honours and was never really inspired to start it back up because meeting attendance never got above five or so. I hope Alan has better luck: he got fourteen for the first meeting.

Alan has given a full account of the talks, so I’ll just note one thing: the presence of Tim Churches, an epidemiologist from the New South Wales Department of Health, who was behind the open source release of NetEpi. If any of the state government’s employees would like to follow suit, it took Tim 18 months and 37 memos to get the release past the government. Beat that!

But the real reason I was particularly interested to meet Tim was that he’s the first example of a phenomenon Anthony Baxter tells me he sees all the time: the professional who just needs a dab of programming and chooses Python because it’s ideal for people who aren’t specialist programmers. Apparently it’s increasingly popular among scientists in particular.

Ubuntu among the Python programmers

I wanted a pressed copy of Ubuntu rather than having to download one, so I went to get one for free. They helpfully informed me that I might as well get a bunch since the cost of shipping massively outweighs the cost of CD production. So I got 10 i386 CDs and 5 PowerPC CDs. I was at a loss for what to do with them — I wore out my parents’ tolerance for installing stuff on their machine when I was 12, and most of my non-geek friends are now canny enough to do the "only if you install it and fix it for me whenever it stuffs up!" trick with proposed Linux installs — so Andrew took them along to the Python meetup and gave them away.

Alan was most impressed that the LiveCD worked on his laptop — alas that with the 4.10 release (Warty) of Ubuntu that’s apparently absolutely meaningless when answering the question "will the installer work?"

Tim was pretty dismissive of Ubuntu though on the "I tried it and it doesn’t even have a compiler!" principle. This isn’t actually true — gcc isn’t installed by default, but it’s supported and I believe it’s on the CD — but since it cost Ubuntu a user I’ll have a closer look at why I think he thought this.

I wasn’t really party to it (I joined the pre-release test team after they decided not to include a compiler in the base install) but as I understand it, the idea was most users won’t want a compiler in their install because most users aren’t programmers and the idea behind distros like Ubuntu is that you shouldn’t need to compile software for it. Further, and this seems to be key, people who want the compiler will know where to get it. Or I assume that was their premise, perhaps with the addition of "developers will read the documentation." (I’m not sure though, "where is gcc?" hasn’t made the FAQs.)

Anyway, it turns out that this isn’t the case. There are developers who, if the compiler is not installed by default, do not think to try and install it because they have no inkling that it might be there. My suspicions about the reasons:

  1. they aren’t former Debian users who are used to their distro having every conceivable piece of Free Software available in a centralised archive: what the installer offers is what there is; and
  2. they are not expert Linux users, by which I mean that they don’t have server sysadmin or security skills. It’s quite hard, in fact probably pointless at this time, to program on Linux without knowing a shell reasonably well, but it is possible to program on it without knowing much about how software gets installed on it. You put a CD in, perhaps select "development workstation" and it installs stuff. When you want newer software, you do a new install. When you want different software you might look at a different distro.

I might be reading too much into this, and in any case developers, whether power users, sysadmins or none of the above, aren’t the Ubuntu market, but assuming that anyone who programs using Linux has Linux expertise above that of a desktop user is probably wrong.

Fixing the Planet <h1> <h2> evil; Bad SLUG, no slug biscuit

Fixing the Planet <h1> <h2> evil

I notice that Andrew’s recent entry has triggered all kinds of evil on Planet SLUG and to a lesser extent on Planet Twisted. The nature of the evil is two-fold:

  1. RSS feeds contain an unrestricted subset of HTML tags, therefore there is a collision between tags the maintainer of the planet wants to use in their own content that goes around the blog entries, and tags the entry authors use.
  2. HTML doesn’t really do sectioning. At one point I heard XHTML2 was going to have section tags with h tagged heading embedded within them. This is a better idea than having the author of pieces of content needing to know what level of heading tag to use to fit into sites designed by someone else.

The solution I’m thinking of using on planets I maintain will apply special CSS properites to headings inside entries to make them less prominent:

 div.blogbody h1, div.blogbody h2 { font-size: large; text-decoration: none; } 

I should look up how to reduce their prominence to screen readers too. Alas, the fundamental semantic nastiness of having the following in the HTML will remain:

 <h2>Blog Entry title generated by Planet software</h2> <h2>Blog entry <em>sub-title</em> coded as h2 by content author</h2> 

Bad SLUG, no slug biscuit

I think Planet SLUG is still sending the character encoding as iso8859-1 while they’re actually sending utf8 content. (eg the character ‘ó’ in Andrew’s entry)

Testing; Online appeals; Ambition

I haven’t even being doing much tech stuff over the last two or three weeks…

Testing

Well, that’s entirely false. I have a new job. A fulltime programming job. In Python. I only just escaped signing a "we own your brain" clause which would have meant that I would have nothing to say because it would be owned. But it was modified and I continue to own my brain during off-hours. And occasionally I will continue to use them for tech stuff.

Tech-wise, the brains’s been busy with thoughts about test driven development, which I’ve never really done before. But I’ve spent large chunks of the last fortnight updating tests to work with modified code. I’m beginning to wonder whether optimally some other programmer should always write the tests for your code. But this may be unsellable: it takes long enough to write tests for your own code.

Online appeals — a review

Andrew and I gave money to the tsunami appeals: Andrew to CARE Australia and me to the Australian Red Cross. (As a side-note, why I am so susceptible to guilt trips? I keep seeing "only ten thousand people have donated through Amazon!" guilt trips around and falling for them. Note to self: failure to donate through Amazon is not any meaningful kind of failure.)

Within one second of my provision of my CC details to those nice folks at the Red Cross an ‘official receipt’ email was on its way to me thanking me for my donation and telling me how the Red Cross is intending to use the funds. Nearly a week after donating to CARE, Andrew’s still waiting for them to actually process the donation and bill his card. (I rather suspect their online billing handlers too the Christmas-New Year week off…)

Ambition

It’s time I had some. I’m close to declaring 2005 to be the year of ambition, much as 2004 was an explicit break from it.

Bouquets; Brickbats

Bouquets

I still don’t like online editing too much, but here’s why I love MediaWiki anyway:

Maturity
As far as I can tell, the software is mature enough to have moved well past problems with doubly or triply escaped ampersands and so on. This sounds fairly trivial, but a lot of wiki software is still in the land where you need to go back through a page every time you edit it and change all occurrences of &amp; to &, lest they be escaped to &amp;amp; on the next page submit! Similarly, I’ve never encountered problems with entering non-ASCII characters into a MediaWiki page.
Talk pages
Every MediaWiki page has an associated talk page, which it’s customary to use for criticisms, meta-discussions, and todo lists. (Not for first drafts though, these are wikis.) It’s amazing how productive I find the ability to make notes of my decisions, rather than silently worry about them.
Edit conflict notification without page locks.
Rather than giving an editor a time-limited lock on a page, a MediaWiki site will let two people start editing a page. However, if the page changes between you beginning to edit it and you submitting your edit, MediaWiki notices and presents you with two input boxes: your edit and the new version of the page. I can see how in some circumstances edit locks are nicer than requiring hand merges, but I generally prefer the latter.

Brickbats

I wasn’t going to do this after the last couple of times, but boo hiss to St George and Optus for having pages incompatible with my browser when they used to work. In the first case at least, it’s due to a buggy commercial browser detector.

Also, a brickbat to Australian English vowels for making it hard to spell. We use the neutral so much that I find it very hard to choose when to use ‘a’ versus ‘e’ in unstressed syllables.

Bugs

I’m averaging about two bug reports every time I try and use Nautilus at the moment: in particular, I have not ever successfully gotten it to talk ssh to a remote server for more than about a minute. I get a lot of ‘seems perfectly stable to me’ replies from upstream, and a lot of ‘yeah, doesn’t everyone know that Nautilus/gmone-vfs don’t really do SSH?’ from everyone else.

But it doesn’t matter anyway, because apparently every time I fill in one of those helpful "your application has crashed, inform developers?" dialog boxes, the bug reporting tool just eats the report. And this is a good thing, because it saves them from ‘otherwise useless’ bug reports.

So I think I’ll save my breath to cool my porridge from now on. In particular, the next time I see someone talking about how Nautilus is amazing if only all these CLI bound nerds would consider using the mouse, I’ll have a quiet laugh to myself and continue using scp, rsync and unison, which I have never ever ever seen crash and file an otherwise useless bug report in my head.

Planet Free Software

Article originally posted at the IT Kitchen, a now defunct project founded by Shelley Powers.

Free Software developers, who had strong mailing list and IRC based online communities before the advent of weblogging, have nevertheless found their way into it. This post is a summary of how the Free Software world is using blogs for collaboration; largely preferring aggregation of community members’ blogs over setting up single access group blogs, and using them as a community building tool rather than a software development collaboration tool.

One of the big developments was Advogato, which started in late 1999. The creator of Advogato, Raph Levien, appears to have been trying to start up a kind of a semi-formal guild system for Free Software developers, allowing them to rank each other as Master, Journeyer or Apprentice. As a small feature, he added the ability for users to make “diary entries”, the most recent of which were listed at the side of the front page.

While the other features of advogato proved only an intermittant success — the quality of the articles on the front page is widely lamented, and the certification system has been subject to a lot of debate and has not resulted in the development of formal mentoring — the diary feature was a smash hit. Waves of Free Software developers hit advogato in 2000 and 2001 as they started reading their co-developers’ diaries. The buzz even generated a Salon article in mid 2000.

The initial buzz surrounding Advogato occasionally caused users to publicly renounce their former bad opinions of “online journals”: rather than being ‘useless’ things full of stories about children and cats, they were a new space to talk about your code and find out more about your fellow developers. Advogato was known as a friendly place, in contrast sometimes with the development mailing lists themselves.

Eventually the worlds of Advogato and of blogs began to meet. In mid-2002 Levien was discovering the wider blogosphere and started exploring using his Advogato diary as a primary means of communication with other interesting people. By that time RSS feeds of individual entries and of the entire recent diary entries page were probably the single most requested feature: people no longer wanted to drop in on the site to skim through the new entries, they wanted to poll them like they were beginning to do with other websites. (RSS feeds of individuals’ diaries were added in April 2003.)

At around about this time also, some people started to express serious dissatisfaction with the Advogato community as political debates became more common and the community attracted a few diary trolls. Levien added a diary rating feature as requests to be able to keep some users off the recent entries page grew. Others used the Advogato article feature to deplore the decline in the community.

As various blogging tools became more popular around this time, it became increasingly common to see diary entries from an Advogato regular announcing that their diary was moving elsewhere.

As RSS feeds became fairly ubiquitous, the Free Software community started to revert to a more typical blogging community model: you read blogs of people whose names you knew, and you found other people you knew or knew of through sidebars and comments.

However, in mid-2003 Jeff Waugh of the GNOME desktop project decided to create his own version of the Advogato front page, a HTML page with recent blog entries from GNOME developers all over the web (including several on Advogato). He used the Spycroll aggregator software to pull in RSS feeds, and he made them all available on a single webpage, with the cute addition of disembodied "hackergotchi heads" personalising each name.

He was stunned with the popularity of the page he linked from his own sidebar as Planet GNOME and started to field all kinds of questions about it: the three most popular were “why isn’t this at planet.gnome.org?”, “why aren’t I on it?” and (to his surprise) “why isn’t there an RSS feed?”

The Planet idea took off rapidly over the next six months. Scott James Remnant was the next off the mark, creating Planet Debian. Remnant and Waugh forked spycroll soon after that to create the Planet aggregator script. In fairly short order, a lot of large Free Software projects needed to have their own planet: the Planet homepage now lists nearly 40 separate planets.

The planets have evolved a loose set of customs based on the ones in place at Planets GNOME and Debian. They do not require that syndicated blogs talk about Free Software or software development all the time: they encourage getting to know your fellow developers as people as well as techs. (John Fleck, a GNOME documentor who is not only a frequent poster, but is a frequent non-tech blogger, has been a kind of an acid test for this editorial policy: see the John Malkovich post and a later complaint.) The larger planets are starting to have to deal with line-ball calls about who should and should not be on the planet pages: Waugh apparently finds requiring that contributors use a real photo of themself somewhat helpful on Planet GNOME.

The planets have proved to be amazingly good at spreading blogging among Free Software communities. The two planets I host, LinuxChix Live and Planet Twisted are close to being my most popular hosted sites. They also fill an important gap in the usual Free Software communication tools: they don’t need to be as on-topic as mailing list posts, and they are more expressive than IRC. They’ve also had some influence on corporate group blogging: Richard Giles reported that the creation of Planet Sun was part of the explorations that led Sun employees to promote blogging internally, eventually leading to the creation of blogs.sun.com.

See also

Creative Commons License
Planet Free Software by Mary Gardiner is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

Questions your conference website should answer

This article was originally posted at advogato.org in 2004.

Introduction

This article gives a list of questions that your conference website should answer, if it is to attract speakers and participants who are unfamiliar with the jargon. Most conference websites do a good job of answering some of these questions, but many go unanswered.

This article is inspired by discussion on the LinuxChix mailing lists over the past couple of years about speaking at conferences; specifically, discussion about how to encourage people to make their first ever talk proposal.

One problem with almost all Free Software conference web sites is that they aren’t very helpful to a novice speaker. One participant in the discussion recollected reading that she would need to send in a "paper" if her talk was accepted and asked what would be required of the paper. Was it an article? How long did it have to be? How did it have to relate to her talk? The only response from the organisers pointed her to mbp‘s (excellent) article on getting a conference abstract accepted, which, alas, helped her not one bit in finding out what it meant to send a paper if her abstract was accepted.

Many Free Software conference websites assume a lot of background knowledge of the conference process. This assumption is a strange one: many Free Software developers work outside academia, and if they were ever inside it, never got to the stage where conferences become part of academic life. And the Free Software conference procedures are subtly different from academic conferences in ways that aren’t obvious, mostly because Free Software conferences are generally more informal events than academic conferences. People used to the peer review process may not be sending in abstracts because they’re used to a very high workload of writing and revision for each conference.

In other words, your conference might a first conference for a lot of people — some of whom are qualified to speak. You need to write parts of your website assuming that potential speakers and attendees know very little of the conference process. This is doubly important since conferences vary in lots of respects: do they pay for travel? are they for users or developers?

Simple general questions about your conference.

Almost all conferences websites answer these simple questions already.

  1. Where is your conference?

  2. When is your conference?

    Give times as well as dates when answering this question, so that people know to book an extra night’s accommodation if your last event finishes at 8pm.

  3. What is the target audience of your conference?

    Are you focused on a particular project, are you a general Free Software conference or a tech conference accepting talks related to Free Software?

  4. Would a user of Free Software benefit from your conference?

  5. Would a developer of Free Software benefit from your conference?

  6. Would a Free Software advocate or someone involved in community projects (like LUGs) benefit from your conference?

Questions everyone wants answered

Many conference websites are doing a good job of answering these questions somewhere, but not all are.

  1. How can I get to your conference?

    It’s worth listing the airport, train station, and bus station nearest your venue and giving some idea of the carriers that travel to that station. If you’re not in a city with a major international airport or transit hub, it’s also worth suggesting a hub for people to travel to, and then a route to your location.

  2. Any visa tricks or traps in your part of the world?

  3. Will international attendees need a visa? Will it need to be a tourist or business visa? Will they need a letter from the conference organisers to get their visa (this is not unheard of)? Will they need to have anything to present to border officials?

    Something conference organisers in the US in particular are apparently still neglecting is this fact: if you are not a citizen of a country whose citizens the US will admit without a visa, it can take months to get a visa to enter the US and it requires considerable time spent gathering documents and visiting consular officials. Accepting speakers closer to the conference will result in your international speakers being unable to come. If your conference is elsewhere in the Americas, it is important to warn attendees that even transiting through a US airport now requires a visa.

    Similarly, visitors to Australia are frequently shocked to find out that the Australian government has no visa waiver program, except for citizens of New Zealand. Nor are the US and Australia the only two countries that trip visitors up with their entry regime.

    In most cases, being denied entry to a country will require your attendees to immediately return home at their own expense. If your conference website addresses the basics of getting permission to visit your country and points to the relevant authorities, you can avoid a lot of pain for them.

  4. What sort of accommodation is available nearby and what is the approximate cost?

    Some conferences are doing excellent work organising conference accommodation. Even if your conference isn’t doing this, you could provide pointers to a few types of accommodation nearby: budget hostels and mid range hotels will be the most useful for your attendees.

  5. What kind of social events are you holding during the conference?

  6. If I bring partners, family members or friends who won’t be attending the conference, is there anything they can do or see while I’m at the conference?

    Free Software conferences tend to be slightly bigger events in the lives of their participants than academics ones. Frequently, attendees combine a big conference with a holiday, and might want to bring their family. Kudos to linux.conf.au 2004 for providing activities for partners and family members who didn’t attend the conference.

    A few more questions: Is the conference providing any kind of childcare? (I’ve never heard of that happening.) Is there short term childcare in the area? Can family members too old for daycare attend the conference social events?

  7. What’s there to do in your area?

    A not insignificant number of attendees will want to combine your conference with a holiday, or at least with some sight-seeing, or a visit to the pub. Give them some information about your area. Link to tourist web sites and nightlife guides.

    Something I’ve very rarely seen done which would be extremely useful is a list of restaurants that are likely to be able to serve large groups of people at short notice late in the evening. Everyone who’s been at a few conferences knows the experience of trying to take fifteen people out to dinner in a strange city.

Questions attendees want answered

There’s going to be even more neophytes amongst your potential attendees than there are among your potential speakers. Try and put yourself in the position of your greenest attendee: has an interest, heard your conference would give him or her an opportunity to meet some hackers working on interesting stuff, but has never ever been to a conference. Aim your attendees section at them: a little extra info won’t hurt anyone else.

  1. What kind of talks can I expect to see? What will their topics be? How long will they be?

    It’s a good idea to get your program up as early as possible. If nothing else, attendees have the same or even more difficulties organising transport, accommodation and visas as speakers do, so you should make it possible for them to decide whether or not to attend as early as you can.

  2. How much will your conference cost for attendees?

  3. Can I get any kind of discount for being a student, unemployed, young, old etc?

  4. Can I volunteer to help out in return for cheap or free admission?

  5. Are there any sources of funding for attendees?

Questions potential speakers want answered

Now to the problem of neophyte speakers. For this section, imagine someone who has some experience speaking to groups, but nothing of abstracts, or proceedings or anything like that. There’s no reason this person can’t speak at your conference, so don’t make it hard for them to submit a talk proposal. In particular, don’t make your talk proposals or the talk process sound any more mysterious or difficult than they actually are.

  1. What do all these words mean?

    Explaining what is expected from an ‘abstract’, a ‘paper’, a ‘presentation’, a ‘tutorial’, a ‘workshop’ and a ‘BOF’ are is crucial if you use those terms. Not only do some people not know them, but they vary reasonably widely by conference anyway.

    Providing links to abstracts and papers from previous years is invaluable if any are available. You might wish to draft a sample abstract or paper if you cannot link to previous papers. If not, you should certainly describe requirements in detail. Place the links prominently with the call for papers.

  2. What kind of talks or presentations can I give? How can I tell which one I should give?

    The answer to this question should provide detail. For each type of talk, specify the length, the size of the audience, and the expected depth of the content if you can. Is it going to be a lecture, or interactive discussion, or something in between? Will most speakers be using slides, giving demonstrations, or running a Q&A session? Are speakers going to be showing the code? What kind of knowledge level can the presenter expect from the attendees? Are the attendees going to be peers or are they going to be people new to the topic? Are there any different "tracks" devoted to different topics?

  3. How do I get a talk/paper accepted?

    When answering this question, be detailed. Provide approximate word lengths for abstracts (or papers if you require full papers at this stage). Specify what kind of information needs to go in the proposal. And then tell people about the process: when do they submit? how (roughly) is their abstract going to be judged? when will they hear back from you?

    Ideally, you would give examples of a few accepted abstracts here, with a short discussion from the selection panel of what made those abstracts appealing to them.

  4. If my talk is accepted, will I still need to pay the admission fee for attendees?

    Norms on this vary: conferences where most attendees are also speaking will often not waive the admission fee for anyone. Be very clear about which way you’re going with this.

  5. If my talk is accepted, will you cover travel and/or accommodation expenses? Will you cover international travel?

    Be very clear about the limits of what you can cover. It’s very disappointing to have a talk accepted and then find out that the organisers can only pay for local attendees, but not for international flights.

  6. If my talk is accepted, will I receive any payment above expenses?

    I’ve never heard of a Free Software conference doing this, but as there are other conferences which may do so, and some of your speakers might come from that kind of world, best to disappoint them early.

  7. What do I need to do once my talk is accepted?

    If you’re asking speakers to provide papers, describe whether you need slides, recordings, or written articles from accepted speakers, together with any administrative extras like due dates for the final paper. Describe any editing processes that will take place.

    Your answer to this question should be detailed. It should explain what you require from a full paper (if you require one) including length and format. How should the paper relate to the talk? How formal should the paper be? If it doesn’t matter, say so. If its optional, say so. If all that is required is a talk, say so. All this talk of ‘papers’ is scaring people. To many first time speakers, especially ones with a passing acquaintance with the academy, a "paper" sounds like something bristling with citations and withstanding the full force or peer review. If what you’re actually doing is getting people to send you their slides tell your speakers this.

    On the other hand, if you are a fairly formal conference hoping to attract Free Software developers outside the academy, you will probably want to link extensively to style guides and citation guides for your potential speakers to use. You will need to assume that they are not familiar with the peer review process also (and it varies enough within academia anyway), so give a detailed guide to it.

Conclusion

If you’ve tried to answer these questions as you went along, you probably answered "well, it depends… small conferences can’t pay travel… Free Software conferences don’t focus on citation so much…"

This is precisely the reason your conference website and publicity needs to answer simple questions like "what do you mean ‘paper’ anyway?" The answer varies. Some potential speakers will submit anyway, and assume they’ll hear from you if they don’t do something. Judging from the discussion that inspired this article, others will not.

Further reading

This article formed one part the basis of the OSDC FAQ, which has other questions that conference websites might want to answer.

Credits

Thanks to Jenn Vesperman, Telsa Gwynne and Terri Oda for input into this article.

Creative Commons License
Questions your conference website should answer by Mary Gardiner is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

Writing a good online diary

Assuming that you have good reasons for keeping an online diary, there are a few things you can do to improve your chances of making your diary readable. I’ll begin by stating the general principles, and then by reviewing a few breakable rules of thumb that, in my experience, are good indicators of an interesting diary.

The general principle of good writing is to determine your audience, and write for them. An online diarist will normally encounter some tension here — the diarists are often writing partly for themselves or their future selves, and the desire to record events that were important to them may conflict with the desire to record events in an interesting way. You will need to decide to what extent you are intending to resolve this tension in the audience’s favour.

It is the case, if I am part of your audience, that your choice of material is generally meaningless to me, and the use to which you put your material is everything, which is why most of these tips tend towards the stylistic.

Tell a story

Of the beginning, middle and end structure, online diarists struggle most with the ending, often because they don’t know it yet. The most successful stories are often trivial anecdotes. However, there may be an ongoing story that you don’t want to record only in hindsight. In this case, you will want to return to it periodically.

It is very very hard to make a story out of emotions you are still experiencing, unless you’re a brutally honest and particularly insightful person, so if you want to write a powerful emotional entry, you may be better off writing an entry that looks back a year or more.

Write long entries

A long diary entry gives you the chance to tell a story, rather than writing an instant message to your readership, and most good online diaries contain at least the odd long entry scattered in their archives.

Very few online diarists seem to be poets, and so generally very few short entries will not become the highlights of your diary.

Drama is the biggest online diary cliche

If your entry is an allusion to misery that only your three best friends in the world can comprehend, your entry will be boring. The high points of an online diary are very seldom the most dramatic entries, save in the case of diaries that resemble an emotional car crash. For the rest, you will need to hone your ability to make the prosaic interesting, because it is actually much easier to do that than to make secretive drama interesting.

Make your entries complete within themselves

Again, if your entry is full of allusions to events you cannot describe in full, and people you cannot say anything about, and feelings that you are unwilling to share, your entry will be boring. If you need to censor something that is crucial to understanding a story, you may as well censor the entire story. In other cases, tell the story in such a way that it is a complete anecdote, even if it is not totally uncensored. If your reader can tell that you’ve left part of the story out, your entry is not as good as it could be.

A subtle style will serve you well

A diary with a unique voice is often an interesting read. One of the easiest ways to achieve this is to let your spoken style influence your written style. It should be relatively sparing, but a touch of spoken mannerisms in a diary makes it more readable.