alan

community

A desktop freeze is something that's not so rare nowadays – that's not good, but we shouldn't get desperate about that.

I like Compiz with Unity Desktop on my Ubuntu Trusty very much; I feel it's a step forward compared to traditional desktops. The only major nuisance I had on the previous versions was the inability to disable the global menu (which I like by itself, but I don't like the global menu disappearing when the mouse is not over it), but you can now disable it and have the menu on the window – even though you can't still enable an always-visible behaviour.

The problem is: compiz sometimes gets buggy. Running a different window manager, like metacity and/or xcompmgr just doesn't seem good, you can experience other issues and you're using the stack in a way it wasn't designed for. I don't like that approach.

So, what can you do when your desktop freezes? The symptoms are usually very clear: you can move your mouse, but you can't click nor type anything.

You don't need to reboot nor to restart X. You can fix this without losing your work.

Get a raw tty

Press Ctrl+Alt+F1 and get to a raw linux console, and login with your credentials. Make sure you use the same user you're logged into X with.

Find and kill your stuck process

pgrep compiz

This will print the PID of our stuck window manager.

Let's kill it

pkill compiz

This won't usually be enough because the process is really stuck: if you repeat the pgrep command above, you'll find it still running – i.e. pgrep will return the very same PID as above.

So let's kill it, really this time!

pkill -9 compiz

Then wait some 15-20 seconds.

Now, if you repeat the pgrep , you'll either see a) no result or b) a different PID.

If you see a different PID, it's Ubuntu that noticed the crashed process and relaunched it; press Ctrl+Alt+F7, and you should just get back a working desktop!

Relaunching

If you see nothing with pgrep, you'll need to relaunch Compiz manually.

You cannot simply relaunch compiz on the console, because it must connect to X: the proper way to do it is:

DISPLAY=:0 compiz

Now switch back to your X instance with Ctrl+Alt+F7 and enjoy!

#MostlyUnixish #linux #ancientwisdom #community #ubuntu #compiz

This is a multipart post. See part 3

Just a brief conclusion to my post sequence; the three principles for succeeding at community-driven projects are:


  • Make it easy for the people to give you their feedback – it's highly valuable.
  • Listen and reply to people's feedback. Don't do every-possible-requested-thing, but reply on time.
  • Don't take any policy as a dogma. Everything can be changed.

#Ollivander #community #OpenSource

This is a multipart post. See part 2

6. State your mission
What's your project for? Who should use it? Which platform is designed for? 

Answer those questions somewhere in your project page. You won't risk people looking for the wrong solution coming to you and asking strange things, and you'll be able to dismiss requests as "out of scope" if they exceed your vision. Sharing such vision with your users is a necessity, or you'll be called a traitor by somebody, someday. As a user, I want to know what requirements was the project designed to accomodate. If I start building a large corporate webapp with tons of users around a small framework designed for personal, low-traffic blogs, I'm probably doomed to fail.

What's you release policy? How do you manage API changes? 
Explain how releases are done. Do you just keep a stable main branch and pull development and bugfix branches in it as soon as they're ready, so you just sometimes tag the main branch and have a release at that point? Or do you create milestone-oriented branches as soon as you release, e.g. version 1.0.0 is got a release-1.0 branch where you apply bugfixes only and release 1.0.1, 1.0.2 from that? Or have you got a "stable" release and a "development" release, but you sometimes pull stable features from development to stable?

All of that is important from the point of view of the user. I want to understand whether an API can change in an incompatible manner from 1.0.0 to 1.0.1. I want to know if I ever get a 1.0.1 release after 1.0.0 or I'll need to pick 1.1.0 with all its changes.

7. Have an homepage
And make it sure you provide its address in README files and such! You don't need a domain name, even though it makes things simpler. It doesn't need to be wonderful - a working one will suffice. You can use Google Sites, or any which Google Code, bitbucket or github provide out of the box.

This may seem a stupid proposition, but in the modern era many users have access to the code for a project without having ever seen the project homepage - central repositories like cheeseshop for Python and maven for Java make this possible.  Then, when it's time to report an issue or ask a question, the user is puzzled and doesn't know where he should head to.

Make sure the homepage contains all the info a user needs. Where does discussion take place, how should I file a ticket, where are docs, what's the latest release, etcetera - everything should be linked there. Sometimes projects use multiple servers to store their data - the repo is on bitbucket.org, the mailing list on sourceforge.net, and the bugtracker is self-hosted. Of course it's better to disable whatever it's not in use, but the point it is: the homepage should be the authoritative reference for everything regarding your project.

And keep it updated! That's why having a domain name of your own, or a subdomain - e.g. myproject.myowndomain.com - might be a good choice - you can just redirect people if your hosting goes down or you'd like to change something.

Having stale information on your homepage will just delay people trying to help and maybe prevent some of them from telling you something.  I really hate when the homepage says the latest stable version is "3.0.5" but the central repo offers "3.0.6" - WTF? If you don't have the time to keep that in sync, just point to a webpage of the central repo and don't duplicate releases on your homepage - nobody says you must.

Next: part 4


#Ollivander #community #OpenSource

This is a multipart article – link to part 1


3. Make it easy to report issues.
Yes, your software is got a bug. Never thought about it, didn't you? And here it is. 

Now, users shouldn't be forced to climb mountains in order to report it. You might not want it to be dealt with just in the discussion area, so a bug tracker is usually a good idea, but just like the discussion group, quick access should be allowed, either via anonymous issue reporting or using a backend supporting a decentralized authentication system. Remember, any bug reporter is doing you a favor! You shouldn't ask too much to them.

Many large open source hosting platforms, like github, launchpad, bitbucket, google code, are great examples of how you can achieve this goal pretty easily.

4. Make it easy to submit bugfix patches.
This is a big one, and I'm sure many people won't agree with me.

Sometimes a patch comes along a bug report, yet many projects have got some coding standards, and they don't accept patches that don't follow such standards. 

Whew. 

Many times, though, either the coding standard isn't really a widely accepted one, like PEP-8 for Python projects, but it's just how the lead developer likes to code, or many old parts of the codebase themselves don't follow such standard.

Hence, after I've discovered a bug in your software, I've debugged it, I've tracked it down and now I'm providing you a patch, you're rejecting it on a mostly cosmetic base because of some principles you alone chose to follow. Thank you very much sir, you're so nice to me. Don't call me by the way, I'll call you if I update my patch to achieve your great coding perfection.

The whole point is, your coding standards are your business. Never forget the Boy Scout rule - you don't have to make every module perfect before you check it in. Removing a bug is enough of an improvement to let a patch be accepted. If you don't want non-complaint code in your codebase just edit the patch – it should be easy for you – don't reject it and don't ask the reporter to edit it.

Of course there are perfectly good reasons to reject a patch. If it's a “worst hack ever” style of patch, or if it adds unnecessary complexity, provokes unintended side effects or changes a behaviour on which existing clients rely, just do whatever you think it's right.

There's another top rejection reason:  missing unit tests or insufficient coverage. Some projects with high coding standards require a unit test for each functionality and maybe 100% test coverage. It's perfectly fine, but there're issues with this choice.

Very often there're some legacy parts of the codebase that have got little test coverage; in order to achieve 100% test coverage the reporter might be forced to create a unit test that does not exist for some code that he has not written. That's a burden and most people will get discouraged.

Other times the overall design in some parts of the code does not allow for easy dependency injection, hence making it hard to create a good unit test which can really test the specific behaviour being patched, and the reporter might be able to reproduce the issue only with an higher-level, more integration-level-like test example.

In both those cases you should remember that the quality of your codebase is your business. You should not reject a patch from being applied because there're no unit tests if creating such a unit test is impractical and the fault is yours. Of course you can create a guideline for patch submission that says that you prefer the issues to be reproduced via a unit test, but don't make it a strict requirement. A patch without a test is better than nothing, you might just pick it up later when you've got some time and write a test for it.

Of course if a patch does not convince you for any reason and you don't get a unit test, just don't apply it – but don't be a template zombie - i.e. don't place policies ahead of people.

If you're unable to reproduce a problem because it happens in scenario you aren't able to test, try checking whether the patch causes any drawback to your supported scenarios. If it doesn't, you might decide to just trust the reporter.

Feature patches are a completely different story IMHO – when you accept something new in your codebase you should  be able to dictate whatever you want.

5. Reply to issues 
Reply to issues. Always. If possible, do it in a reasonable amount of time, which should be, in my opinion, ten days at a maximum. You don't have to take immediate action. Your reply could just be Investigating the issue or something like that. Remember the Inbox Zero approach to GTD: don't let unread, unaccepted bug tickets linger in your bugtracker! A lingering ticket is the first stop on the path to killing community support to your project.

The same approach is valid for issues with an attached patch – say something. Don't let issues linger unanswered.

And never, never wake up after a bug has been lingering for months just to ask the reporter if it “still applies”! This is terrible, I hate it when it happens. “Sorry, being too busy but did 37 releases of my software in the meantime, could you check if this still happens with the latest?”. You're probably in a better position for verifying the issue – assuming that a way to reproduce it is provided – on any release, since you made them.

The next part will deal with APIs and public info for your project – see part 3

#Ollivander #community #OpenSource

There's a lot of buzz about open source software lately. Many projects are supposed to embrace the Bazaar development model, but they really don't, and their leaders just seem to ignore users a lot. This often leads both to wild forking – one new feature, one new fork that's never merged in the original code base – and to multiple incomplete implementations – there're many projects to satisfy a single need, but none of them is complete.

What should you do to make your project successful? Those are my guidelines. I've split the post into pieces since it was growing too large for a single entry.

This is mostly developer-oriented; I think supporting a community of end-users might be slightly different, although concerns might sometimes be similar.


1. Make it easy to discuss about your software.
Something might not be clear about your software, whether it's usage, availability, license, scope, and so on. It must be easy to ask a question, whether it's on a mailing list, on a forum or by any other mean – Launchpad Answers or GetSatifaction are good alternatives – just don't make it too hard to just ask a question!

 If you're using a custom forum or any other portal, make sure it supports a decentralized authentication system, be it OpenID, Google Account, MSN or whatever you like. Very often creating a new username/password couplet, fill in a few forms, clicking to verify an email, etc. etc. may just be too much an hassle for somebody who just wants to ask a small question.

Similarly, if you're using a mailing list, make sure it's not too hard to get subscribed; if possible, just let anyone post a question – then a “reply all” from any list subscriber should reach the poster. Don't moderate subscriptions and posts unless you've got a really good reason to – e.g. too much spam that automatic filters can't handle. Consider using mailing list providers that make it easy to use the ML from the web as well – Yahoo Groups and Google Groups are great examples; they'll give a great overall user experience, and satisfy those who prefer forums and those who prefer mailing lists at the very same time.


2. Answer questions and doubts.
This seems a silly one, but it isn't. Make sure users get a minimum of feedback, be it just a “read the FAQ”, or “it's not implemented yet” or “I don't know”. Any message left lingering is a big thumbs down for your project.


3. Have a FAQ

This was pretty common during the nineties, I can remember being turned down with a “Read the FAQ” many times when I was young and inexperienced, but it's not such frequent thing anymore. There're some questions that get asked again and again. If you don't mantain a FAQ you can't tell people “Read the FAQ!”, and you'll need to answer the same question again, and again, and again. And you won't like it.


Link to part 2 - bug reporting and patch submission.

#Ollivander #community #OpenSource