Monthly Archives: November 2013

Updating documentation for 3.10

5642995221_84a6f913b7_bWith only a few hours to go until the 3.10.2 tarballs are due, here’s a recap of what the documentation team has been up to:

  • gnome-user-docs started being updated for 3.10 mid-September: it is moderately difficult to test the UI and functionality before the 3.x.92 release
  • the updates were done by 10 documentation team members and translators
  • after the docs-i18n brainstorming at GUADEC, the docs team made sure to keep translators up-to-date on what was happening
  • the changes in the UI affect almost every one of the 293 live pages
  • updating 293 pages takes a lot of time and the updates were not finished in time for 3.10.2 so there will be a 3.10.3 release sometime before next year
  • the translators appreciate the docs team how-to for taking screenshots almost as much as knowing  what’s going on
  • screenshots are still a pain to update
  • the docs team sucks at giving translators enough time for translations

As the docs team has been concentrating on the desktop help, some of the application help has been neglected a bit, which is somewhat unfortunate. There are also a few things that could make updating both application and desktop help easier for the team, such as fewer UI changes between each major release, notification emails about freeze breaks (not all developers send these), fewer UI and functionality changes after the freeze.

Visiting California

We made our third trip to California last month for the GSoC Doc Camp and took the opportunity to travel around a bit, as we always try to do.

Capitol Reef

In 2011, we did a trip around the National Parks over 13 days which included driving down Highway 1, finding out that it fell into the ocean, getting stopped at a border control point near Mexico and a 2.5 day stint (with three magnificent hikes) in Yosemite. All of this only happened thanks to Chris‘s awesome help in planning it out.

6993863840_c3b1f88444_k

We were unable to take holiday in 2012, so only visited Yosemite for the weekend as it is only a 3.5 hour drive from San Francisco. We finished off pretty much all the possible day hikes from the valley and visited the Mariposa Grove of Giant Sequoias. We rather enjoyed the circular hike past Vernal Falls, along the Panorama Trail and down the Four Mile Trail so decided to do a two day hike on our next visit, and camp at the top of the valley.

l1006715_wide

This year was our first autumn visit to California, but the weather was great, so we decided to see if Highway 1 had been fixed (indeed it had) and to drop by Yosemite again.

Now the thing about the Big Sur area of Highway 1 is that it passes through a whole bunch of national and state parks. There’s also not much in the way of places to stay unless you’re camping. Of course, most of the camp grounds are run by the parks… which is a bit inconvenient if all the national parks are “closed” because the rangers are not getting paid. We ended up staying at San Simeon State Park in a “primitive” camp ground (it had running water, toilets, fire rings and parking spaces).

Things to see down Highway 1 are… (mostly) the coastal countryside, the McWay Falls (I found it underwhelming, although the history is quite interesting), very cute elephant seals, Sequoia forests, windy roads (which are quite fun to drive down), “historic” (1930s) bridges and Morro Rock, a volcanic plug. If you’re out of things to do, then the Mill Creek Trail is pretty flat and ends in a nice Sequoia forest. The trail head is very easy to miss, so you’re unlikely to meet hordes of tourists up there.

l1006715_wide

Skipping a week ahead, we camped at the Hodgdon Meadow entrance to Yosemite, which surprisingly allows camp fires. Surprising because the Stanislaus National Forest, which borders Yosemite, was still on fire at the time. The wildfire started on August 17th and was only put out on October 24th after it had burnt through 402 square miles (1041 square km) of woodland. Suffice to say, the drive in looked quite surreal with a white-leafed and black-trunked forest… and that was where there was anything more than blackened stumps left.

We were originally planning to go hiking around Toloumne Meadows, off the Tioga Pass, but it was too late in the year to park overnight up there as the risk of snow is quite high by mid-October. Instead, we grabbed a Wilderness Permit in the valley and headed up the Snow Creek Trail for a circular hike around to Yosemite Point and down past Yosemite Falls on the other site. We managed to lose the trail at the top of Indian Ridge, camped there for the night, had an easy walk across to Yosemite Point, lost the trail again (it’s quite difficult to follow on solid rock without markers) and managed to miss the black bears on the way down.

We did manage to find some snow for the third year in a row, and the autumnal colours made a bit of a change from the usual greenery. The streams were quite low on water, so there were no visible waterfalls, but there was enough to top up water bottles.

Things to see in Yosemite are‥ lots of rocks, wildlife (bobcats, small deer, large deer, friendly rodents, not black bears), waterfalls (overflowing in spring, almost non-existent in autumn) and steep trails out of the valley. Maybe next year, we’ll get a chance to do one of the hikes outside the valley.