• Archives

  • Categories:

  • Other profiles

Help out with the Saucy Ubuntu Docs!

Throughout this cycle I have been working with the Ubuntu Doc team in my capacity as a Community Council member to assist in building up the number of team administrators and work to improve the Getting Started documentation to get new contributors involved with the documentation that ships with Ubuntu. I’m happy to say that the actual amount of work I did was personally pretty minimal; administrators Doug Smythies, Kevin Godby, Benjamin Kerensa really worked hard this cycle to get things into shape, and there is a significant amount of activity on the mailing list today from other contributors.

Ubuntu Desktop Guide

Now that some of the major hurdles have been tackled, the team is slowly reaching out beyond the immediate community to get more contributors — that’s where you come in!

We need reviewers for the new Ubuntu Desktop Guide how-to: DocumentationTeam/SystemDocumentation/UbuntuDesktopGuide

Does this guide make sense? Does it give you the introductory tools and information you need to start working on documentation? What is missing? Let us know on the Ubuntu Doc mailing list (if possible, sign up for the mailing list so your mail doesn’t get moderated, we want to make it easier on our new list admins!).

Not ready to dive into full documentation writing with Mallard? We also need folks to simply review the documentation. You have a couple options for reviewing the current documentation:

1. Review the 13.04 documentation on the web

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

This is the easiest way to quickly get involved.

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

2. Build the current development documentation as html

This method is more complex and takes a little time, but you will be reviewing the actual development version of the documentation.

  • 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 10 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. You can open file:///path/to/ubuntu-docs/html/build/en/index.html in your browser (where “/path/to/” is where you put the docs, like /home/elizabeth/)

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. It looks quite empty now, but don’t be shy :) If all the pages have been reviewed once, feel free to pick a page and review it a second time!

Keep in mind that 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

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.

Thanks to Kevin Godby for working with me on this post!

Miscellaneous life stuff from July and August

It’s been a crazy busy summer. Looking back through my blog, I see that for the past 2 months all my posts have somehow been event, open source or travel related. Crazy! I assure you, I have been doing normal life stuff as well, like…

Doing laundry.

Taking pictures of street cars as I wander around downtown.

Making raisin challah when I’m in town to do + enjoy it!

Getting a new bedroom set (the mattress came a day later).

Hosting Ubuntu Hours, during one of which a kid dropped by our table and asked the unforgettable “Who do you think would win in a fight, a salamander or a penguin?”

And enjoying oysters by the bay.

I love San Francisco.

We also managed to get out to the movie theater to see Iron Man 3 last month. I’ve been going down to Mountain View a couple times a month too in order to meet up with MJ and some Google folks for dinners, which has been fun and a nice distraction from being in the city all the time. Plus, train ride! Say what you will about Caltrain, it is fine for the occasional jaunt down the peninsula.

I also gave my Introduction to Ubuntu talk at ITT Tech in Concord again in July. It had been a year since I’d done so and it was pretty astonishing to see that the class this time was really interested in learning about Linux and Open Source in order to pursue a career in that direction. I was also interviewed during OpenStack’s 3rd birthday flurry of blog posts in July: OpenStack Blog: Open Mic Spotlight: Elizabeth Krumbach Joseph which ended up causing a quote of mine about in production adoption being passed around a couple of articles. I had a chat with Rikki Endsley about the best advice I’ve gotten as a sysadmin, which ended up in her article Advice from sys admins, for sys admins.

Throughout all my crazy travel I’ve been releasing the Ubuntu Weekly Newsletter each week, worked with UnixStickers.com to get them to begin selling Xubuntu stickers and helped coordinate the XMir testing, which was a lot of fun because it engaged so many more users than our standard testing does, even if we didn’t end up defaulting to it in the end. These past couple weeks in Ubuntu Women land we launched both a Project Survey and a new competition in the form of a Fact Finding Scavenger Hunt.

Books! On the fiction side I’ve not read much, but after a recommendation I did pick up Everything Matters! Ron Currie Jr. which was great, even if it defied my moratorium on apocalypse books (and satisfied the reason why I imposed such law upon myself). For non-fiction I picked up Search Inside Yourself by Chade-Meng Tan, which is turning out to be very good for me since my tech brain is very skeptical of all this meditation stuff, it’s nice to have an author who gets that and offers up studies backing up his claims. I also have been browsing a couple of time management books, so far Laura Vanderkam’s 168 Hours: You Have More Time Than You Think has been the most useful as far as perspective changes go, she reminds me that I really do need to start making time to go to the gym again. Travel time has also afforded me the ability to make a nice dent in my magazine stack.

It was really great to have our friend Danita in town last weekend. In addition to the penguin breakfast and our California reception, she joined us on our first visit to the new Exploratorium, now located at pier 15 on the Embarcadero. It was really crowded, so we may consider going on a calmer day some time, but I was really struck by how many adults without children were there – and not only were they there, they were right there along with the kids trying out the science exhibits! As an adult who did this but always felt a bit awkward at science museums back east, it was nice to see a science museum here that was so engaging to everyone. I’ve uploaded photos of our Exploratorium adventure here: http://www.flickr.com/photos/pleia2/sets/72157635136622926/

Last Monday shifted my schedule up an hour so I could join MJ and Danita in Santa Cruz where we spent the evening riding on rides, including my favorite roller coaster, the Giant Dipper! We also played some mini golf and I ate too much salt water taffy.

Which brings us to this weekend! Our wifi router has been going bad. It completely fell over a couple weeks ago and we left it unplugged for about a week (no wifi at home at all!) and then plugged it back in while Danita was visiting and it magically worked for a few more days. MJ decided to take the opportunity of this failure to redo our entire network this weekend. It’s been a fun weekend of rewriting and reorganizing our computers and network. There is still more to do (like install a faster secondary NIC in my desktop, replace my speakers and add a KVM switch for my new work desktop) but things are coming along nicely as far as the network configuration goes, and we have wifi back. Hooray for a formally planned network strategy!

California Wedding Reception

Since we had our wedding on the east coast we decided to also host an event on the west coast for friends here, many of whom couldn’t make it across the country for the wedding itself.

It took some time to plan, but last Saturday we finally had our event! We ended up going with EPIC Roasthouse on the Embarcadero as the venue, as we’d been there several times ourselves and the location right next to the Bay Bridge made for a beautiful view during the day and at night. We scheduled the event to begin at 6PM so our guests could enjoy the bay in the sun and also as the evening wore on could see the Bay Lights display on the bridge. We also did a quick once through of our wedding photos and had a few books of photos printed up to place on the tables so people could see some of our wedding photos.

From my perspective, evening went beautifully. I was able to meet some more of MJ’s colleagues and it was great to see some of my friends I hadn’t seen in a while (particularly with this crazy year, wedding + new job has caused quite the busy schedule!). My cousin who lives here in San Francisco was also able to join us, which was a nice treat since he couldn’t make it to the wedding either.

I was curious as to whether the food for an event would be on par with what we got in the restaurant, but it absolutely was. We had a limited menu that we selected for the event that people were able to order from (plus a vegetarian option). We also ended up staying about an hour past the end time for the event when they stopped serving just to catch up with people.

And with the end of the event, we wrapped up our final formal celebration of our wedding. Huge thanks again to all our friends and family who were able to join us. Now to finish those thank you cards and get our wedding photos online!

More photos from the event here: http://www.flickr.com/photos/pleia2/sets/72157635129113141/

Launched git.openstack.org

On of my projects these past couple months has been reviewing, testing and finally implementing an in-house git repository for the OpenStack project to satisfy the bug Create a git.openstack.org mirror system.

Full rationale, from the bug report by Jeremy Stanley:

Right now our Gerrit server (review.openstack.org) replicates its Git repositories into /var/lib/git/ and serves them from a local Apache instance as https://review.openstack.org/p/projectname, but it also replicates the same projects to Github. Most of our developer documentation suggests cloning these from Github, but this could be misconstrued as the OpenStack Project endorsing use of Github (which is not itself free/libre software).

While developers can and do set their origin to the replica on review.openstack.org, this is a single point of failure and hosted on a server already doing quite a lot of other work. Github on the other hand is a distributed/redundant service with a lot of available bandwidth, so any solution to this should probably at least involve some minimal amount of redundancy and not add further traffic load on review.openstack.org. As a bonus, any automation which we currently point at the Gerrit server but which only requires access to officially merged change history could be repointed at git.openstack.org instead to take advantage of the additional stability and redundancy.

We finally launched the new git.openstack.org this week! And we quickly scaled up to having multiple servers as the load from the tests alone quickly overtook a single instance, so we’re now using HAProxy to load balance between several nodes.

For human-readable access, we went with cgit which is also used by kernel.org and the Fedora project. Visit it at: http://git.openstack.org/cgit

cgit

There are many options for cgit, Anita Kuno is looking into getting .rst files rendered in the interface and there are syntax highlighting options we can look into. If you’re interested in these or any other options, let us know. Or better yet, submit a patch for us to review. Documentation on this new git infrastructure, including links to configuration files is up at: http://ci.openstack.org/git.html

We’re also running git-daemon for access via git:// and made git-http-backend available for cloning over http(s).

Breakfast with the Penguins at the San Francisco Zoo

This past weekend our friend Danita was in town visiting. To kick things off I dragged her and MJ out of bed at 7AM to head to the San Francisco Zoo!

This year we missed the annual March of the Penguins where the new baby penguins of the year are introduced to the colony on penguin island at the zoo (we went in 2011). So when the opportunity to do Breakfast with the Penguins came up on a weekend I’m not travelling I couldn’t resist.

The event kicked off at 8:30 with check in and hot breakfast in the main hall, a building I hadn’t been in before. As we finished eating there was a short presentation by the head penguin keeper about the history of the penguin colony at the zoo and the work they’re doing now. Plus, lots of pictures of baby penguins!

Then the really fun part began – seeing the penguins! There were over 100 people attending the event, so we were split up into 2 classrooms in the building for our penguin visit. Inside the classroom we sat in a large circle as the keepers brought in 2 penguins to run around the room!

The first two were 5 month olds who favored one corner of the room (not ours!) so they swapped penguins with the other room and that seemed to work out better, we got another 5 month old and a baby from last year named Eduardo who stole the show with his hyperactivity and how social he was.

Here’s Eduardo and my knee! Naturally when a penguin is right there next to me I am taking bad photos :)

You could tell which was the 5 month old penguin, she has her first year coloring:

And Eduardo didn’t jump on us, but he did come by to visit Danita a few times, I managed to get this picture:

In all, a memorable event and totally worth waking up early for. We’ll have to go again next year!

While we were at the zoo we also did some visiting with some of the other animals in the zoo, getting to see the baby tiger Jillian, who is looking less and less like a baby…

And Erin the giraffe, who was never small, and is only getting bigger!

More photos from the penguin encounter and the rest of the zoo here: http://www.flickr.com/photos/pleia2/sets/72157635135525958/

Fosscon 2013 Wrap-up

This past weekend MJ and I traveled to our old home city of Philadelphia to attend Fosscon. It was great to see that this year attendance doubled over the previous year and topped out over 300.

The keynote was given by Jordan Miller who works on bioengineering at Rice University. He spoke on how he was drawn to the open source community through hardware projects that could help with the work he was doing, specifically work with the RepRap maker community to use the inexpensive 3D printer to start printing sugar-based scaffolding for the creation of skin and veins and eventually more complex organs! It was really exciting to hear about this work and I think everyone wanted to go home and print some livers afterwards. I think most rewarding for me though was his commitment to Doing Open Source Right and stressing that it’s “not a checkbox but a philosophy.” He wrapped up by discussing the newly launched AMRI: Advanced Manufacturing Research Institute (see blog post about it here) where they seek to “provide breakthrough mentorship, infrastructure, and research funding for promising young makers to pursue their interests using the scientific method.” Cool.

My talk directly followed Jordan’s in the main room. It was very similar to the one I gave at OSCON but modified slightly to stress the Open Source way in which we do Systems Administration rather than focusing too much on code review. The audience was delightfully engaging and I had some great chats about OpenStack and the specific tools we use after I finished the talk. Slides are up here: Open Source Systems Administration.

I then attended Dru Lavigne’s talk on the features of FreeNAS 9.1. We’ll be building a couple of file servers at home in the near future and FreeNAS is a contender for what system we use to manage it. She did a quick overview of the coolness of ZFS and I was delighted to hear about some of the UI improvements to help users use more resilient disk array setups.

For lunch I met up with LaMaia who contacted me several weeks ago about PhillyChix (which we may revive!) and several other women we snagged in the lobby to do a women in FOSS lunch. Unfortunately I missed the opportunity to meet up with Leslie Birch for this lunch, but we managed to meet up later in the day for a discussion she mentions in her FOSSCON Field Notes!

Lunch ran a bit late and I came in late to John Ashmead’s fun and interesting talk on Invisibility Theory & Practice. I enjoyed the vanishing cat. I stuck around that room for Chris Nehren’s talk Devs and Admins Sitting in a Tree but the talk was really directed toward developers hoping to make their sysadmins happier, with the only real advice for systems folks being to learn some coding and make sure you monitor things.

I quickly stopped for the essential Oreo Cake (thanks again, jedijf!) before heading off to Brent Saner’s talk on the mesh networking project he’s working on in Philadelphia called Project.Phree. They have lofty goals that include recycling of hardware and community building so it will be interesting to see where it goes as he reaches out to more geek-types to get support and contributors.

My day wrapped up by going to a talk by my friend and Fosscon co-founder Christina Simmons on Starting, Building, and Managing Your Open Source Event/Project. The work put in to event and project management in FOSS absolutely deserves more attention and she put together an excellent presentation drawing from her extensive experience in event planning and then applying it to the work they’ve done with Fosscon. This stuff isn’t as easy as intuitive as you might think, and in my early days of planning one-off events I sure would have liked to have known more! Plus, how awesome is it that I was at a FOSS conference sitting next to my Maid of Honor while one of my Bridesmaids gave a presentation? We are some seriously awesome chix.

After event party was hosted by Github at a nearby pub where we enjoyed drinks and good company.

Huge thanks to the Fosscon organizers for putting together such an enjoyable conference. It was a lot of fun and always great to visit so many of my Philly friends again!

More photos from the event here: http://www.flickr.com/photos/pleia2/sets/72157635045154436/

Fosscon on August 10th

Next week we’ll be heading back east to Philadelphia for the 4th annual Fosscon on Saturday, August 10th.

I gave the keynote at this conference in 2011 and this year that honor goes to Jordan Miller of UPenn who will be talking about AMRI: Building Open Source Infrastructures for Science.

I’m coming back to give a presentation on Open Source Systems Administration, drawing upon my work at HP with the OpenStack Infrastructure team.

Abstract: The infrastructure for the OpenStack project is managed in public by a distributed team of systems administrators from several companies all over the world collaborating online. You will get a whirlwind tour through the tools we use to accomplish this and some of the benefits, trade-offs and challenges that the team encounters.

My talk will be at 10:35AM in Linode Hall.

It will also be great to visit with my old friends from the Pennsylvania LoCo who are running the “Hacker Hall” along with folks from Hive76. From their announcement:

Interested in trying Linux? Now’s the time. A convention full of computer and Free Software enthusiasts.

Running linux on a usb drive and ready to move it to your device? Take the plunge. We’ll be here to help you install.

Already installed but need a hand with the basics. Stop by and we’ll guide you.

What’s this command line stuff I keep hearing about? Come by, and we’ll have a Command line Boot Camp.

Have old equipment lying around that you don’t know what to do with? Stop by and we’ll help you repurpose the old into something new and wonderful.

All distributions of Linux are welcome. All levels of interest are welcome.

Demo machines will be available to try.

Bring your laptop or desktop(only), we’ll have all the other peripherals (Keyboards, monitors, etc) to install Linux on almost anything.

Sounds like it’ll be a great conference!

Xubuntu featured in Linux Identity magazine

Several months ago Xubuntu project lead Pasi Lallinaho (knome) was contacted by the editor of Linux Identity Magazine about doing a flavors section of their magazine for release in June. Together Pasi and I worked last cycle to recruit authors, meet deadlines, gather pictures and screenshots and do editorial review and final article length extensions. It was more work than we had anticipated, but it was all worth it when I received my copy in the mail this week:

You may notice several familiar names as authors!

Huge thanks to everyone in our community who took the time to write an article.

The magazine is available for purchase here: Linux Identity Starter – Ubuntu Family 13.04 Raring Ringtail

Yes, it has been pointed out that they called 13.04 an LTS. We didn’t do review on that part and didn’t see the error until publishing.

Matti’s Wedding in Boston

MJ and I spent this past weekend in Boston, Massachusetts to attend the wedding of MJ’s friend Matti, who was his Best Women at our wedding back in April.

Since I was tied up with OSCON, MJ flew in a day earlier than me to settle in and meet up with Matti and some other friends on Thursday. I came off the red eye from Portland, OR and was able to meet him at the hotel in the late morning where I took a much-needed nap before lunch. That evening we spent at a small pre-wedding celebration with family and close friends arranged by Matti’s mother.

The weather on Saturday was perfect for the wedding. Tucked between days of rain, the sun was out and the temperature was in the high 70s to low 80s all day. They held their small, quick ceremony on the banks of the Charles River. It was beautiful!


Matti and Mark get married!

MJ and Matti!

Once complete, all of the guests walked over to the restaurant where they were hosting their lovely reception dinner where we had some time to chat with Matti and Mark and the other guests.

The trip was a short one and we flew home Sunday afternoon, vowing to return more often as there are a number of things we’d like to see and do in Boston, and more people to visit.

Congratulations Matti and Mark! It was an honor to join you on your wedding day!

More photos from the day here: http://www.flickr.com/photos/pleia2/sets/72157634872482427/

OSCON Day 4

The 4th day of OSCON was the last one for me this year, with a redeye flight on my horizon so I could be in Boston for a friend’s pre-wedding festivities on Friday night.

The day began with a series of keynotes. The first that really stood out for me was one about CODE2040 by Laura Weidman Powers. She boldly spoke about race in the technology sector head on as she gave a series of interesting statistics about race in the industry and the growth of technology jobs and how quickly it has outpaced the supply of qualified workers. As such, they (and I) believe that broadening the pool of people in technology by reaching out to underrepresented racial minorities is the way forward. They do summer fellowship programs for blacks and latino/as and more to support these communities.

There were also a couple of keynotes about government, Code for America spoke about some of their work with the city of Oakland to help improve engagement between government and citizens with an open source question-style web portal. And Leigh Heyman from the Executive Office of the President came on to talk about the open source offerings for developers that have come from the White House, including sites at whitehouse.gov/developers, petitions.whitehouse.gov/developers and their github repo. The morning also had a couple of talks about licensing, discussing the importance of having one and stressing that not bothering to have one actually makes it less free, and the rise of permissive licensing in open source, as opposed to strongly copyleft licenses.

The first session I attended of the day was “Good enough” is good enough! by Alex Martelli of Google. The audience was pretty much in agreement about the “release early, release often” mantra so he had an easy crowd as he explored the history of debate behind the argument over how “perfect” software should be before release and several examples of where “less perfect” technologies have found success because they were available while better solutions were locked up in being perfected by their creators. But I think the most valuable portion of this talk for me was his overview of what not to skimp on when you’re developing software but not seeking perfection, his list included: revision control, documentation, security and proper coding and release practices. Slides here.

Next up was my talk!

In Code Review for Systems Administrators I began by giving an overview of the fully open source code review and continuous integration (CI) system that our Infrastructure team manages for the OpenStack project. The point of my talk was that we not only manage this system, but put our own changes (in puppet, system scripts, other config files) through automated testing and peer review as well, making it a really great infrastructure for collaborative systems administration. It was great to field questions about this process and have colleagues in the room who were able to speak to some of the history behind this (“Was it planned to do the administration this way?” “No, it happened organically when random people wanted to help us fix things!”). At the end of the session I was really happy to get to talk to some other folks who were interested in implementing similar code review and CI systems for their projects. Slides from my talk are online here: Code Review for Systems Administrators slides

After lunch I went to Reducing Identity Pain by Tim Bray of Google who began by impressing upon the audience that when a user has dozens of password to keep track of, rules like this are “mean”:

And then went on to talk about the job of securing these passwords, which major organizations fail to accomplish on a daily basis, leading to weekly headlines about major breaches. His plea was for use of federated identity systems so that users can simply use an identity provider they want without having to have separate logins for each site. His talk discussed OAuth2 and OpenID technology and reviewed Google’s identity toolsets for developers to make implementing it easier. He also gave examples of some clever ways that sites have allowed users to use identity providers of their choice without having dozens of icons cluttering up the login page.

Next up on my schedule was Creating a User Journey for Your Open Source Community by Francesca Krihely. She gave examples of types of users that needed attention in communities: n00bs, sophomores and experts. From these examples she gave ideas for how to best each of these groups through clear, targeted documentation on the website that was specifically designed for each level. Beyond just software, she also suggested getting users in touch with each other (user and study groups locally) and perhaps having expert programs that more experienced users can qualify for once they reach a certain level, where they have an elevated path to report and discuss feature concerns. I’ve certainly seen a need for easier on-boarding in some of my communities, so it was an interesting talk to attend.

I then met up with colleagues to attend Monty Taylor’s talk on TripleO: OpenStack on OpenStack. Since I’m intimately familiar with the project through testing I’m working on putting together, I didn’t gain a whole lot from it technically, but hearing further project rationale and future plans is always super helpful. It was also interesting how meta this discussion gets when you’re talking about bootstrapping and launching things from each other, cool concepts but it sure takes some explaining!


Monty Taylor presents on OpenStack on Openstack (TripleO)

Last talk of the day (and the conference!) for me was PiDoorbell: Home Automation with Arduino/RaspberryPi by Rupa Dachere. The room was packed and it took several minutes to get the live demo set up, but the wait was worth it. Her talk centered around the use of a motion sensor, Arduino, Raspberry Pi and webcam to detect when someone is at her door and take a 10 second video of them, which is then uploaded and she is sent a text message to be notified of the event. Her live demo worked (hooray!) and was quite fun to watch. Over the weekend MJ ended up making a comment about how we should put a camera on Simcoe’s bowl to see if Caligula eats from it when we’re not around and I immediately thought of Rupa’s talk. Perhaps with an infrared camera…

I didn’t mention the expo hall at all, but it was a good one. The Ubuntu booth was pretty busy the whole time as far as I could tell, every time I tried to drop by to say hello they were crowded.

In all, great OSCON, I hope to go back next year!