• Archives

  • Categories:

  • Other profiles

5 ways to get involved today: Ubuntu Documentation

At the Ubucon at Southern California Linux Expo on Friday, February 21st I’ll be doing a presentation on 5 ways to get involved with Ubuntu today. This post is part of a series where I’ll be outlining these ways that regular users can get involved with while only having minimal user-level experience with Ubuntu.

Welcome back! In this second post I will take the opportunity to introduce you to the Ubuntu Documentation team.

Ubuntu Documentation

Like the Ubuntu Weekly Newsletter that I mentioned in my last post, this effort is completely volunteer-run and pulls in community members from throughout the Ubuntu desktop and server community and the flavors. The team is small, but over the past year it’s been growing and could really use some new contributors.

One of the easiest ways to get involved is by reviewing the development version of the Desktop documentation and submitting bugs when you find issues. Review can be in the form of grammatical review or technical review, and we can always use folks who are keeping up with new features so we’re sure to document them.

You have a couple of options when it comes to doing review.

1. Review the 13.10 documentation on the web

https://help.ubuntu.com/13.10/ubuntu-help/

This is the easiest way to quickly get involved. Your task here is reviewing this documentation and seeing if there are any errors or updates to be made for the upcoming 14.04 release.

Tip: We have already updated some of this in the latest development version for 14.04, but there still may be errors to find so reviewing this is useful to us.

2. Build the current development documentation as html

This is a bit more involved because you have to install some things on your system, but it’s the best way to help us because you get the latest version of the documentation that’s currently in development!

The steps for building are as follows:

  • Install the following packages: bzr xsltproc libxml2-utils yelp-tools yelp-xsl
  • At the command line, type: bzr branch lp:ubuntu/ubuntu-docs (this took several minutes for me, be prepared to wait!)
  • Change to the new ubuntu-docs html directory: cd ubuntu-docs/html/
  • To build the HTML documentation, just type: make
  • View the resulting HTML documentation in the html/build/en/ directory. I did this in my home directory, so I just opened file:////home/elizabeth/ubuntu-docs/html/build/en/index.html in my browser (replace “/home/elizabeth/” with whatever directory you ran the bzr command in)

Tip: When reviewing documentation built on your system keep an eye on the address bar to make sure the pages you are reviewing are still your local file:/// ones, there are some links in the documentation that take you to other sites.

Reviewing instructions

To prevent everyone from reviewing the same few pages over and over again, we’ve created a spreadsheet to track which pages still need to be reviewed. Visit the spreadsheet and find a page that hasn’t been reviewed yet and add your name to the Reviewer column. If all the pages have been reviewed once, feel free to pick a page and review it a second time!

The Ubuntu Documentation adheres to the style guide here: DocumentationTeam/StyleGuide. Of particular interest may be the Grammar, Punctuation, and Spelling section. Also note that the Ubuntu documentation uses US English spelling and grammar rules.

If you find a bug, please report it here: https://bugs.launchpad.net/ubuntu/+source/ubuntu-docs/+filebug

Tip: All screenshots are done at the end of the cycle once the UI has frozen, this is done automatically by a team member so it’s typically not required to submit bugs related to screenshots.

If you have any questions or run into any problems, please feel free to email the Ubuntu Doc mailing list at ubuntu-doc@lists.ubuntu.com or chat with us in the #ubuntu-doc IRC channel on irc.freenode.net.

And when you’re ready to go beyond review? Full instructions for contributing (including submitting changes in Mallard rather than submitting bug reports!) here: DocumentationTeam/SystemDocumentation/UbuntuDesktopGuide

5 ways to get involved today: Ubuntu Weekly Newsletter

At the Ubucon at Southern California Linux Expo on Friday, February 21st I’ll be doing a presentation on 5 ways to get involved with Ubuntu today. This post is part of a series where I’ll be outlining these ways that regular users can get involved with while only having minimal user-level experience with Ubuntu.

In my first post of this series, let’s take a look at the Ubuntu Weekly Newsletter!

Every week, the Ubuntu Weekly Newsletter is read by thousands of community members, it’s cross-posted to several resources so for the release of issue 353 on Monday you could find it via:

Contributing to the newsletter is a great way to contribute to something that community finds valuable.

I’m happy to say that today we have some really exceptional work coming from Paul White who participates from beginning to end: link collection, summary writing and editing. We recently gained Emily Gonyer who has been putting in tons of effort each week on summary writing and keeping an eye out for accuracy of articles. And finally, we still regularly have Jim Connett popping in for editorial review at the end of the release cycle.

But we don’t want to burn out these contributors! It’s a lot of work to put together the newsletter every weekend, and we need folks for the following:

Summary writers. Summary writers receive an email every Friday night/Saturday morning with a link to the collaborative news links document for the past week which lists everything that needs summarizing. These people are vitally important to the newsletter. The time commitment is limited and it is easy to get started with from the first weekend you volunteer. No need to be shy about your writing skills, all summaries are reviewed before publishing so it’s easy to improve as you go on. We also provide Style Guidelines to help you out (and you can always look at past issues!).

Editors. Our editors receive an email every Sunday night/Monday (depending on our timing and your time zone) with a link to the wiki page ready to be reviewed. Editors check for grammar, spelling, formatting and other consistency issues. Good written English skills, attention to detail and willingness to adhere to our style guidelines required.

Interested in either of these? Email editor.ubuntu.news@ubuntu.com and we’ll get you added to the list of folks who are emailed each week and you can help as you have time. Please specify whether you are interested in summary writing or editing when you contact us. And if you find you can’t participate or want to be removed, you can always be removed from the list of people contacted each week, just ask :)

OpenStack Infrastructure February 2014 Bug Day

The OpenStack Infrastructure team hosted our last bug day back in December. Since then, elastic-recheck has become a pretty big deal and the community has had to become more diligent about rechecking against actual bugs in the infrastructure, meaning our bug tracker has been much more active! In general, the team has been doing a better job of keeping track of new bugs coming in, so our stats for today didn’t show the kind of dramatic drop that some might hope for.

But these days are still valuable to us! Even I found a couple bugs where I could offer updates, we were able to take time to triage a bunch of New bugs that hadn’t been touched, and shuffle around priority of many others. It’s a great time for us to get a higher level view of everything on our plates so we can make plans accordingly.

Ladybugs

First, I created our etherpad: cibugreview-february2014 (see etherpad from past bug days on the wiki at: InfraTeam#Bugs)

Then I run my simple infra_bugday.py script and populate the etherpad.

Then I grab the bug stats from launchpad and copy them into the pad so we (hopefully) have inspiring statistics at the end of the day. Once bugday makes it into infra proper I hope to update that to include us too, there is a bug for that, and now a review!

Then comes the real work. I open up the old etherpad and go through all the bugs, copying over comments from the old etherpad and making my own comments as necessary about obvious updates I see (and updating my own bugs).

Last step: Let the team go to town on the etherpad and bugs!

Here are the stats from today:

Bug day start total open bugs: 266

  • 45 New bugs
  • 45 In-progress bugs
  • 5 Critical bugs
  • 17 High importance bugs
  • 4 Incomplete bugs

Bug day end total open bugs: 245

  • 0 New bugs
  • 46 In-progress bugs
  • 5 Critical bugs
  • 22 High importance bugs
  • 17 Incomplete bugs

Nice work, thanks again everyone!

And it’s February on the home side

Work and projects have certainly kept me busy, but I’ve also had time for home, self and family things.

Caligula wasn’t the only one who had some dental work done, both MJ and I had to go in at the end of January. I was reminded the hard way that Novocaine upsets my stomach, but aside from the queasy afternoon everything went well.

In the midst of being so busy lately, I realized I should probably work to get out to socialize more outside of work/conference/event things. I do have friends in the city now, so I really need to do a better job of reaching out to them when I’m feeling lonely.

Last week I finished off the 5th week of Couch-to-5K with a brutal 20 minute run, thankfully for week 6 it was back to a mix of running and walking. It was cool to learn that I could run for a full 20 minutes though, even if it was painful and difficult!

Last week my Aunt Mary and Uncle Joe were in town for a conference and I was able to meet up with them for a couple meals. Early in the week we met up for drinks and then for a great dinner at Zero Zero. On Saturday we met them in the late afternoon for a quick visit to Pier 39 (sea lions! view of Alcatraz!) before we drove over the Golden Gate Bridge for an exceptional dinner at Murray Circle Restaurant at Cavallo Point. Afterwards we spent a bit of time there at Fort Baker soaking in the view of the city and the bridge.

The weekend wrapped up with some work at home. We finally received the last lamp we ordered from the bedroom, and also were able to take time to hang the mirror we bought with the first lamp.

It’s so nice to finally have a mirror over the dresser! And with this completed our bedroom is pretty much done. I think completing the living room will be our next project.

We also have our computer project to complete, getting our media server and storage server online. I was reminded of this even further when I got on my desktop this morning and was confronted with a wall of filesystem errors. I’ve put in an order for a couple new drives, which is not what I had planned on doing this week, but will finally give me the opportunity to set up RAID1 for my desktop so I don’t need to be quite so worried about drive failures (I keep backups, but, you know).

A couple articles, PyCon and a keynote in Croatia

It’s hard to believe that January is already over. It was quite the full month with my trip to Perth and then a lot of work and project stuff happening. Looking at my calendar for the year I seem to have a pretty full schedule, during which I’m also dying to squeeze in a visit to my youngest sister and my nephew in Maine (aiming for March).

Last month I was happy to see my Code Review for System Administrators article come out in the January issue of USENIX ;login: logout. It’s an online-only publication but it was great to be able to transform the talk I’ve given on the subject to text, and working with Rikki Endsley is always a pleasure. I was also interviewed several months back my comments made their way into Issue 180 of Linux Format in Jono Bacon’s Equality and open source article.

Apologies for the pay wall for both of these articles, if you’re a USENIX member you can grab the ;login: logout article, and the Linux Format one should be available for general consumption in the next few months.

Logout

In conference news, I’m officially one of the TAs for the Build your own PiDoorbell! Learn Home Automation with Python workshop at PyCon 2014 in Montreal in April. I’ve never attended a PyCon and I’m super excited about meeting up with Akk, Rupa and the other TAs to start learning what we’ll be teaching others. I’m thinking I’ll set up my motion sensor next to Simcoe’s food bowl so I can make sure Caligula doesn’t eat her food. I’ll also be pitching in at the HP booth during the conference days.

PyCon 2014

I also learned on Sunday that not only is HP going to be a sponsor of DORS CLUC 2014, a Linux User Group Convention in Zagreb, Croatia in June but will be giving a keynote! I’ll be there to talk about the fully open source Continuous Integration system that we use for the OpenStack project. Bonus, this will be my opportunity to finally meet Jasna Benčić, a rising tech star who I met through work on several Ubuntu projects a couple years back, including her tireless work on the Ubuntu Weekly Newsletter and Ubuntu Learning.

DORS CLUG

I’ve put in a few more talk submissions to other conferences, so it’s shaping up to be a really exciting year.

Ubuntu California planning for the Southern California Linux Expo

The Ubuntu California team does a lot of small events throughout the year, from release parties and jams to regular Ubuntu Hours all over the state. But our big event of the year is always the Southern California Linux Expo.

We kick off the expo with an Ubucon on SCaLE’s Friday of miniconfs.

Ubucon

I’ve had the pleasure of being invited to speak at this event for the past few years, and this year is no exception! The Ubucon lineup for Friday the 21st is as follows:

My 5 ways to get involved with Ubuntu today talk will cover ways that regular users can get involved with while only having minimal user-level experience with Ubuntu. In preparation, this week I’ll also be launching a series of posts where I’ll be outlining these ways as a bit of a sneak peek as to what to expect during the talk.

On Saturday and Sunday the team will be running an Ubuntu booth in the expo area. Over the years we’ve gotten quite skilled at knowing what we should bring and have used the wiki to list out everything we need to have folks sign up to volunteer and bring things:

https://wiki.ubuntu.com/CaliforniaTeam/Projects/Scale12x

This year I’m fortunate to have Robert Wall making the trek down to SCaLE by car, so he can bring along all the booth items I signed up for (no stuffing them in my suitcase!) as well as having him on booth duty. Also thanks to Philip Ballew, Stephen Briles, Mickey Lyle, Matt Mootz and José Antonio Rey who have already signed up for booth duty throughout the weekend. We also have System76 to thank for providing us a couple demo laptops for the booth and the rumor is Canonical has loaned us a couple of phones running Ubuntu to show off too.

SCaLE11x booth
Our booth at SCaLE11x in 2013

I’ll be dropping by the booth as time allows, but I learned a couple conferences ago that I don’t have the energy to run a booth all weekend and speak at a conference. My second talk of the weekend will be at the main SCaLE conference on Code Review for Systems Administrators on Saturday at 6pm, where I’ll be talking about the system we use for the Infrastructure team of the OpenStack project (my day job!).

Simcoe’s January vet visit and Caligula’s cold

Simcoe’s last vet visiting to do an analysis of her blood levels was back in November. Since we noticed her levels were creeping up at the time, but she also had some sniffles, perhaps that impacted results? We came up a plan with the vet to recheck her in 2 months (rather than 3) and went ahead and scheduled her appointment to coincide with some dental work Caligula was having done.

We dropped Caligula off at the vet the morning of January 25th and commenced worrying about him all day. Unfortunately those sniffles I mentioned Simcoe having back in November were ones that had continued with Caligula over these past couple months with varying severity. We put him on antibiotics in mid January, but they decided to do a sinus x-ray prior to the dental work to figure out what was going on and whether they could go on with the dental work. He was still congested so they decided to give him an antibiotic shot this time and go ahead with the dental work. He came out from the dental work a bit drugged but ok. They followed this up with a culture to see if he had a bacterial infection.

Results from the culture came back Wednesday, he has a strain of Pseudomonas. It’s resistant to both antibiotics he’s already been on so we picked up a third type yesterday and started the treatment last night. Simcoe is sniffling again too, so we my need to put her on it too.

When we went to pick up Caligula following his dental work, we had scheduled a vet visit for Simcoe. Since he had the cat carrier, we put her on a harness and lead to go to the vet, which she really was not at all happy with, she prefers being able to hide in her carrier.

The exam went well, she’s continuing to maintain a health weight, which is always a good sign for a cat with renal failure. Last visit she was 9.5lbs, this time she’s 9.6lbs.

Unfortunately both her BUN and CRE levels have gone up a little, 53 to 57 on BUN and 3.5 to 3.6 on CRE.

BUN: 57 (normal range: 14-36)
CRE: 3.6 (normal range: .6-2.4)

This is something to continue to keep an eye on if the trends continue in this direction.

For now we’re back on the 3 month check in schedule and will handle her sniffles as needed, hopefully this round of antibiotics will do the trick for Caligula.

CloudCamp Hackathon and Ubuntu User Days

I’ve had a busy weekend! On Friday night I headed over to the San Francisco Hub for a CloudCamp Social Good Hackathon sponsored by HP Cloud (my employer) and Intel.

The event kicked off with an introduction, including words from Dave Nielsen where he spoke about CloudCamps and touched upon how HP Cloud uses OpenStack and works in the OpenStack community. As part of the sponsor team, I wasn’t participating in the hackathon teams, but it was my job for the evening to make sure folks could get signed up for their HP Cloud accounts and use the promo code for the event. It was really cool to see the HP Cloud Horizon interface being used. Hooray Horizon!

It was a great experience for me to get out of my infrastructure and development mindset and see all the work we do with OpenStack paying off in powering the servers that developers are using to build real applications. The Hackathon itself was also inspiring because all of the projects were for social good, from finding mental health resources to helping to solving the pipeline problem related to women in STEM.

Sunday I was able to have some great chats with colleagues and others about how OpenStack cloud platforms could better serve the application developers. It’s clear that some of the terms that systems administrators and infrastructure developers are very different from the world of application development, and some of the concepts can be confusing. I see a fair amount of people using file sharing services to move files where it seems to me a proper object store with an API would be optimal.

I didn’t attend on Saturday due to my previous commitment to host Ubuntu User Days. Over the past several weeks, Jose Antonio Rey and I have searched the community for volunteers to give user-level classes in the Ubuntu Classroom IRC channels for our day of sessions. I was keen to make this event a success after missing one for raring, but we kept the schedule to only 9 full sessions so it was manageable and we maintained the quality we were seeking in instructors and sessions.

I’m happy to report that we didn’t have any last minute cancellations, no shows or timezone mix-ups! The instructors were all talented and professional and made for a series of sessions that we should all be proud of.

Session logs were made available directly following each session:

Huge thanks to all the community members who participated in this event.

My pink WASD keyboard

I like the color pink. Over the years I’ve collected lots of pink electronics that have measured up to their non-pink counterparts, from pink ethernet cables (hey, that’s my photo on Gizmodo!) to my pink netbook that has traveled the world with me (frequently still seen at Ubuntu Hours, always came along to Ubuntu Developer Summits and recently was at the OpenStack Summit in Hong Kong).

Keyboards have always been tricky though. Ones that come in pink tend to be princess or Barbie themed for little girls, which means they are either too small or of poor quality. I have found some larger, adult-ish pink keyboards, but they have never been mechanical, which is my strong preference. I’m on my keyboard all day, a good keyboard is important.

Then my friend Karen McLoughlin Largent posted a picture of her custom-colored keyboard from WASD Keyboards. It was pink! And mechanical! Be still my heart!

I went with the WASD V2 104-Key Custom Mechanical Keyboard with Cherry MX Blue switches (though Brown was also a contender), no sound dampeners, and all the keys in pink, with Classic layout and function keys, just like my current IBM keyboard.


I was going to crop my messy desk, but if you look close, I have the following pink items peeking into this photo: pen, mini swiss army knife, earbuds, USB cable, USB stick

Oh, and the final thing that made me spend over $150 on a keyboard? They let you have a custom OS key, and Ubuntu (as well as Linux Tux) were part of their default options.

Even better? I live near where they put them together, so I ordered it Wednesday and with no rush and standard shipping I was plugging it in to my computer on Saturday.

I love it. It’s much more clicky than the Model M successor IBM keyboard that I had previously used, which had dampeners, but after an hour I was quite at home with my noisy new friend. Hooray!

Much ado about otters and lamps

Last week I had a cold and was getting over jet lag, just like when I came back from Hong Kong! So this is my second cold of the season. Fortunately, this one seems to be clearing up more quickly than the last but I’m still not thrilled that I’ve been knocked over by colds twice since November. Most of the week I just focused on my work and slept a lot, ignoring everything else.

By Friday morning I was feeling more alive and had a much more productive work day with my head finally clearing. I even managed to get out on my next Couch-to-5K run, even if I was sniffly and more out of breath than usual. It was really good to get out of the house.

Saturday I got around to making Challah french toast for the first time, it was as delicious as everyone told me it would be. Side of turkey bacon too.

The rest of the day was mostly spent catching up on some reading and doing some other “day off” tasks. After sundown we headed down to Colma for some home stuff shopping. Later in the evening I was able to get some of the Partimus accounting stuff behind me, including the year end report for the board, now that I have all the bank stuff from my name change squared away.

Sunday I went out for my run and then hunkered down to get caught up with open source work I had been ignoring all week. I still have a lot on my plate, but I’m happy to say that the Ubuntu Weekly Newsletter was in nice shape for release today and our schedule for Ubuntu User Days on Saturday is almost complete.

In the late afternoon we decided to head to Fisherman’s Wharf for some fried seafood. There were too many birds, I was happy when we vacated the bird area and went over to see the sea lions at Pier 39. There are more of them than I’m used to seeing, I’m happy to see that they are almost back up at numbers seen 10 years ago. While we were there we also decided to swing by the Aquarium of the Bay to finally see their Otters: Watershed Ambassadors exhibit, featuring a trio of adorable river otters, Shasta, Tubbs and Wildcat.

But the otters where sleeping in a big pile of otter cuteness while we were there and weren’t up for entertaining us further:

It was nice to see them though, even if it was just in snuggle pile with their heads popping up here and there. The jellyfish were also cool (naturally, I waited for the pink light to take my picture).

Today was a bank holiday here in the US, so I had some shopping lined up. First it was to get new running shoes, we shall see tomorrow if having new shoes prevents ankle soreness. We then we went out to do some bedside lamp shopping, which is pretty much the last piece we needed to complete our bedroom.

We shopped around a bit, and ended up at Lamps Plus where we had a very pleasant shopping experience. The staff was friendly and helpful and we also managed to get an mirror that I’m hoping we can hang soon. Unfortunately most of what we wanted was out of stock, so we had to shift our order a bit to have the rest of it shipped to us. I did get to bring home one bed side lamp though!

Tomorrow I hope to make it out to the BALUG meeting on CiviCRM. We’ve been trying to get CiviCRM going for Partimus, but our lack of people power for maintaining it both software-wise and content-wise has prevented this. I’m hoping a talk about it will inspire me to have another look. This upcoming Friday, part of Saturday and Sunday I’ll be helping out with the Openstack CloudCamp Social Good Hackathon, I’ll be pitching in to make sure folks can get registered with our infrastructure and documenting the fun with my camera.