DITA

Hello world!

The Content Wrangler - Mon, 2015-04-20 00:57

Welcome to WordPress. This is your first post. Edit or delete it, then start blogging!

Categories: DITA

Hello world!

The Content Wrangler - Sat, 2015-04-18 19:39

Welcome to WordPress. This is your first post. Edit or delete it, then start blogging!

Categories: DITA

Gilbane Advisor 4.16.15 – The Apple Watch’s Raison D’être

Gilbane Conference 2015 call for papers deadline is May 1 Learn more The Apple Watch’s Raison D’être John Kirk is mostly right, but there is more to say. Though it’s fun to speculate on Apple’s initial intent, it is more useful to consider how the Apple watch actually fits into the the evolution of computing, and […]

This post originally published on %%http://gilbane.com%%

Categories: DITA

Running Spark GraphX algorithms on Library of Congress subject heading SKOS

bobdc.blog - Sun, 2015-04-12 13:55
Well, one algorithm, but a very cool one. Bob DuCharme http://www.snee.com/bobdc.blog
Categories: DITA

Gilbane Advisor 3.31.15 – Is a Mobile Deep Linking Standard Necessary?

Gilbane Conference 2015 call for papers Share and network with your peers as a speaker at our next conference. Fairmont Copley Plaza, Boston. December 1-3.  Learn more How to Launch Your Digital Platform …I draw from this research to offer a framework to help aspiring entrepreneurs make the right strategic decisions as they build their own platforms… […]

This post originally published on %%http://gilbane.com%%

Categories: DITA

Spark and SPARQL; RDF Graphs and GraphX

bobdc.blog - Sun, 2015-03-29 16:24
Some interesting possibilities for working together. Bob DuCharme http://www.snee.com/bobdc.blog
Categories: DITA

Male allies for women in tech: What’s needed?

JustWriteClick - Mon, 2015-03-23 11:58

I realized the other day that I have given my “Women in Tech: Be That Light” presentation a half a dozen times in the last year. One question that I still want a great answer for is when a man in the audience asks, “What can I do to make it better? How can I be that light?” I have ideas from my own experiences, and also point to the training courses and Ally Skills workshops offered by the Ada Initiative.

flickr-ngmmemuda-ally

On a personal level, here’s my short list based on my own experiences. My experiences are colored by my own privileges being white, straight, married with an amazing partner, a parent, living in a great country in a safe neighborhood, working in a secure job. So realize that even while I write my own experiences at a specific place in my career, all those stations in life color my own views, and may not directly help people with backgrounds dissimilar to mine.

What do women in tech need? How can I help?

  • Be that friendly colleague at meetups, especially to the few women in the room, while balancing the fact that she probably doesn’t want to be called out as uniquely female or an object to be admired. If you already know her, try to introduce her to someone else with common interests and make connections. If you don’t already know her, find someone you think she would feel comfortable speaking with to say hello. It’s interesting, sometimes I’m completely uncertain about approaching a woman who’s the only “other” woman at a meetup. So, women should also try to find a commonality — maybe one of her coworkers could introduce you to her. For women, it’s important make these connections in friendly and not competing ways, because oddly enough, when I’m the second woman in the room I don’t want to make the other woman feel uncomfortable either!
  • Realize that small annoyances over years add up to real frustration. I don’t point this out to say “don’t be annoying” but rather, be a great listener and be extremely respectful. Micro annoyances over time add up to women departing technical communities in droves. See what you can do in small ways, not just large, to keep women in your current tech communities.
  • For recruiting, when new women show up online on mailing lists or IRC or Github, please do answer questions with a “there are no questions too small or too large” attitude. I never would have survived my first 90 days working on OpenStack if it weren’t for Jay Pipes and Chuck Thier. Jay patiently helped me set up a real development environment by walking me through his setup on IRC. And since he was used to Github and going to Launchpad/Bazaar himself, he didn’t make me feel dumb for asking. Chuck didn’t laugh too hard when I tried to spell check the HTTP header “referer” to “referrer.” I felt like any other newbie, not a “new girl” with these two. (Woops, and I should never use the term “girl” for anyone over the age of 18.)
  • Recognize individuality when talking to team members, regardless of visible differences like gender or ethnicity. I struggle with this myself, having to pause before talking about my kids or my remodeling projects, since not everyone is interested! I struggle with assumptions about people all the time, and have to actively fight them myself. For men, you don’t want to assume an interest in cars or sports, so really this applies regardless of gender. All humans struggle with finding common interests without making assumptions.
  • See if you can do small, non-attention-drawing actions that ensure the safety of women in your communities. With the OpenStack Summit being held in different cities twice a year, I’ve been concerned for my personal safety as a woman traveling alone. Admitting that fear means I try to be more savvy about travel, but I still make mistakes like letting my phone battery die after calling a cab in another city after 11 at night. If you see a woman at a party alone, see if you can first make her feel welcome, but then also ensure there are safety measures for her traveling after the event.
  • If you see something, say something, and report correctly and safely for both the bad actor and target. This is really hard to do in the moment, believe me, I’ve been there. For me, being prepared is best, and knowing the scenarios and reporting methods ahead of time gives me the slightly better confidence I can do the right thing in the moment even if I’m shocked or scared. Find the “good and bad” ways to deal with incidents through this excellent Allies_training page.

If you’ve read this far, you really do want to make life better as a male ally. Realize that it’s okay to make mistakes — I’ve made them and learned from them over the years. This inclusion work by allies is not the easiest work to do, nor is it rewarding really. It’s the work of being a good human, and we’re all going to screw up. If someone points out a foible to you, such as saying “girls” instead of “women,” say “thank you” and move on, promising to do better next time.

If you think you already do all these things, make sure you look for ways to expand your reach to other minority groups and less privileged participants. I’m trying to do better with the physically different people I encounter at work. I would like to find ways to work well with people suffering from depression. I’ve got a son with Type I diabetes, what sort of advocacy can I do for people with unique medical needs? I’m asking myself how to make a difference. How about you? How can you do your part to equalize the tech industry?

Categories: DITA

Call for Papers now open – Gilbane Conference 2015

The Gilbane Conference 2015 helps marketers, IT, and business managers integrate content strategies and computing technologies to produce superior customer experiences for all stakeholders. Please review the conference and track topics below and submit your speaking proposal. Additionally, answers to the most common questions about speaking at the Gilbane Conference can be found in the Speaker Guidelines. Deadline […]

This post originally published on %%http://gilbane.com%%

Categories: DITA

Be sure to read about my Stacker journey

JustWriteClick - Sat, 2015-03-14 19:49

The editors at The New Stack do great things with their articles, and mine is no exception! Be sure to read Anne Gentle: One Stacker’s Journey.

Even though I’ve lived in Austin, Texas, for over 14 years now, I tend to say I’m a midwesterner when asked. There are traits associated with the spirit of the midwest that I’ll always identify in myself: hard work, resource creativity and conservation, humility, and a sense of wonder at trends being set somewhere in the world. Read more…

Categories: DITA

Gilbane Advisor 3.10.15 – We Need to Break the Mobile Duopoly

Gilbane Conference 2015 dates & location Fairmont Copley Plaza, Boston, December 1 – 3. New web site and call for papers will be live in a few days. We Need to Break the Mobile Duopoly. We Need a 3rd Mobile OS Andreessen Horowitz’s Peter Levine makes an interesting case. Note he is talking about an open OS – and what he doesn’t say […]

This post originally published on %%http://gilbane.com%%

Categories: DITA

Gilbane Conference Advisor 3.10.15

Gilbane Conference 2015 dates & location Fairmont Copley Plaza, Boston, December 1 – 3. New web site and call for papers will be live in a few days. We Need to Break the Mobile Duopoly. We Need a 3rd Mobile OS Andreessen Horowitz’s Peter Levine makes an interesting case. Note he is talking about an open OS – and what he doesn’t say […]

This post originally published on %%http://gilbane.com%%

Categories: DITA

“What Software Do We Need?” Is The Wrong First Question

The Content Wrangler - Tue, 2015-03-03 21:53

Scott Abel

Scott Abel

By Scott Abel, The Content Wrangler

As a content strategy consultant, I’m often called upon by brands seeking to find ways to solve complex content challenges. Far too often, they start off their quest for a solution by asking the wrong first question: “What software do we need?”

This is the wrong first question for a wide variety of reasons. The most important reason is that software products are tools, not content solutions, no matter what software company marketing mavens would like you to believe. Tools help content professionals solve content challenges and meet business goals. Tools, by themselves, do not solve content problems.

Experienced content strategists know that determining the right tool for the job means asking the right first question, “What are you trying to accomplish?” The answer to this question is usually quite revealing. Most teams attempting to overcome content challenges have difficulty clearly articulating the problem they hope to solve without ending up in the weeds. They start by attempting to describe the problem as they see it, but somehow digress into discussing implementation issues, tools, and technologies.

Savvy content strategists have developed processes designed to extricate the information they need from their clients. The process usually starts with helping the client articulate the challenge, define goals, and explicitly declare the measures to be used to determine success.

The right first question is only the beginning. There are always additional questions in need of answers before talk of software selection begins. Some typical questions include:

  • Why do you create the content you create?
  • How do you create it?
  • Who creates it?
  • Where do they do this work?
  • What does it cost you to create it?
  • What do you want it to cost you tomorrow?

Without knowing the answers to these questions (and many others) selecting the right software for the job is likely to be an elusive and expensive guessing game.

It’s important to do your homework before you go tool shopping. Software company salespeople are trained to help match your problem to their ‘solution’. They make commission each time they convince you to solve your problems by purchasing software. They lure you in with the promise of a positive return on investment (ROI) — a promise that might become a reality, if you know exactly what you are trying to accomplish and why. But, chances are, you don’t.

Steve Walker

Steve Walker

“If you don’t know why you create the content you do, what is costs to do it, what your goals for that content are, and how you will measure success,” asks Steve Walker of Experis Global Content Solutions, “how will you know if you succeeded?”

“If you don’t know the answers to these questions,” Walker asks further, “how can a software salesperson promise you ROI? They can’t.”

Calculating ROI involves mathematics, not a list of features or the inclusion of sexy buzzwords in a white paper or web presentation. Calculating ROI involves predicting potential savings and revenue. Predicting increased revenue involves a mix of psychic power, lessons learned from the successes of others, and a little trial and error. But, to predict savings you must know what it costs to do business today.

“Sure,” Walker says, “some software companies produce ROI calculator tools that they claim will help you determine likely ROI. But, upon close inspection, most of these calculator tools are nothing more than a clever way to get you more interested in purchasing software.”

Businessman drawing ROI (return on investment)

“They’re smoke and mirrors and seldom do anything more than map your problems to the features in the software they want you to purchase,” Walker adds.

So what’s a well-intentioned knowledge worker to do when put in charge of finding the right tool for the job?

One approach is to seek help from a neutral third-party to help you find your way.

“Find someone to guide you through the process,” advises Sean Mattson, Senior Director, Global Web Marketing at Hitachi Data Systems. “You need someone who has been-there-done-that. Someone knowledgable with a proven track record. Someone not beholden to a particular software company. That’s what we did. As a result, we not only avoided the mistakes of those who tried solving similar problems, but we also completed our project on time and within budget.”

Tools and technology decisions should be informed by a both a complete picture of the problem to be solved and a clearly defined, measurable set of goals. If you don’t have the knowledge and experience required, perhaps the best first question will be to ask someone more experienced for help.

Categories: DITA

State of the Migration to Sphinx/RST

JustWriteClick - Mon, 2015-02-23 14:02

I wanted to document the migration journey while we are in the middle of it. Last week the OpenStack Super User site did a great article about the migration, How you can help with the documentation site refresh. We talked about the reasons for it: enable more contributors, offer simpler markup, be more Pythonic.

And more Pythonic we are. Let’s dig into what’s going on with the migration, what we’ve learned, and what we still have to learn.

Migration process

We’re nearly done with patches to review converted End User Guide files, but just a few Admin User Guide files are complete. Sign up on the OpenStack wiki at Documentation/Migrate. I’ve figured out how to include certain files in a build conditionally with an extension we’ll call “scope” for now. Using (and abusing) the meta information by putting a special directive in a file meant for admin-only lets us “tag” certain files for inclusion and build output with those files included.

New docs.openstack.org content page designNew docs.openstack.org content page design

How to build locally

We have always had tox jobs for building and testing the docs. The newest one runs the sphinx-build command for the end user guide.

If you don’t want to use tox, install these prereqs locally to test only the build:

pip install sphinx; pip install openstackdocstheme

Next, switch to the directory containing a conf.py and run:

sphinx-build /path/to/source/ path/to/build/

This command builds html output by default.

In troubleshooting some markup I found that the sphinx-build command does not give as much information about the markup as python setup.py build_sphinx does. So I will test a switch with a setup.py file as well as a conf.py file for each guide in the openstack-manuals repo.

To build locally with tox, follow the instructions on the wiki page. Building with tox is preferred as that matches our gate tests for patches. Feel free to ask for help in #openstack-doc on freenode IRC if you run into errors. We have tested the instructions on Linux, Mac, and Windows.

Conventions and editing RST markup

Docs tools guru Andreas Jaeger already had a head start in adding RST markup conventions to our Documentation/Markup_conventions wiki page on the OpenStack wiki. I’m finding that there are some types of content, such as extra information embedded in a list item like a table, that just can’t come over in its current state. I’m still working through these questions and it seems as though numbered lists can’t have much more than single list items. Anyone with info, please let us know if these are possible:

  • How to get numbered list continuation to work when you have a table after a #. list item?
  • How to get numbered list continuation to work when you have a bulleted list between #. list items?
  • How to get get embedded .. note: directives to work between numbered list items?

Matt Kassawara asked if there is a side-by-side editor for RST like there is for Markdown, and so far there is not, but the Sphinx development mailing list has a thread about what authors currently do as well as what they’d like to build.

Priorities

We still need output bugs fixed. To me, the top priorities are:

  1. Sphinx template needs precise “Log a doc bug” link created on-demand similar to current functionality
  2. Sphinx openstackdocstheme needs to be tested for the translation toolchain
  3. Sphinx openstackdocstheme doesn’t style admonitions (note, warning, important) correctly
  4. Plus sign appearing when numbered list followed by bulleted list

What I need to understand is what would compel us to update Sphinx itself, considering we don’t know when their next release is. We already pin to a beta version (1.3b) so perhaps  we can patch as needed and pin our version.

Troubleshooting

Generally, make sure your Python environment is installed and ready to go, and then use a virtualenv to be sure you have “corded off” the environment and know exactly what’s installed.

Use “pip freeze” to get a list of what is installed. If a package is missing, make sure you have access to pypi by running the pip install command with -vvv. Also if you’re not working in a virtualenv, ensure you run the install command with sudo on Mac or Linux.

If you’re working within a virtual machine like VirtualBox, you may find that networking settings change even if you go from wired to wireless or from one wireless network to another.

If the output looks strange to you, delete the /build/ directory then re-build. I suspect that CSS and JS files remain outdated or are not copied over every time.

Please log bugs in openstack-manuals with the tag “openstackdocstheme” if you see bugs in the output.

What this means for new guides in progress

The only new guide in progress is the Networking Guide and some of it’s in markdown, some of it’s in DocBook, and all of it can go to RST. We must get the translation toolchain working prior to publishing, and I’d prefer to get more output bugs fixed prior to switching any more guides.

 

Categories: DITA

???: ???????????????

DITA Blog - Sun, 2015-02-15 14:43

???????????????????????????????????????????????

?????:

Categories: DITA

??????

DITA Blog - Sun, 2015-02-15 13:15

1

1

?

??????
???????????

????2??????????

????2???????????????SEX???????????????

????2????????????????????????????

????2??SEX???????????????????

????2????TSUTAYA????AV???????????????

????2???????????????????????????????

????2??????????????

?

?????????
????????????????????????????????????????

?

????2???????SEX????????????????????????

????2???????????????????????????????????????????

????2?????????????????????????

????2???????????????????????????

????2SEX???????????????????

????2????????????????????????????

????2???????????????

?

???????????????????????????????
???????????????????

?

???????????????????????????
??????????????????????????????????????

?

4

?????????????????????????????????????????

?????????????????????????????????

?

??????????????????

??????????????????????????

?

???????????????????????????500??????????????

???????????SEX??????????????????????

?

??????????????????

?

??????????????????????????????????????????????????????

?

????????????????????????????????????????

5

??????????????????????2?????????

???????????????????????????????????

?

???????????????????????????????????????

????????????????????????????????????????????

?

????????100%?????????????????????????

?????????80%???????????????????

?

?????????????????????????????????

????????????????????????

?

?????????SEX??????

?

????2????????

????2???????

????2??????

????2??????

????2??????????????

????2???????????

????2???????????????

????2??????????

?

????????????????????

?

???????????????????????SEX?????????????

??????????????????

?

????????

6

?????????

??????????????????

????????????????????????????????

?

?????????????????????

??????????????????????????????????

?

?????????

????????????????????????????????

?

????????????????

?

??????????????SEX????????????

????????????????????????????????

?

???????????????????????

?

??????????????????????????

??????????????????????????????????

?

????????????????????????????

???????????????????

??????????????????????????

?

1

?

????????????????????????????????????

?

?????????????????????SEX?????????????????

?

??????????????????????????????????????????

??????????????????????????????????

??????????????????????????

?

????????????????????????????????????

???????????????????????????????????

?

???????????????????????????????????

?????????????????????????????????????????

?????????????

?

????????????????????????

?

?????????????????????????????SEX??????????????

??????????????????????????????????????

?

???????????????????????????

?

???????????????

????????????????????????????

?

????????????????????

?

?????????????????????????????????????????????

???????????????????????????????????????

?

?????????????????????????????

???????????????????????????????????

??????????????????????

?

????????????????????????

??????????????????????????????

?

????????????????????????????????SEX?????????????

?

????????????????????????????????????

?

?????????????????????????????????

?????????????????????

?

??????????????? ?????????

?

???????????????????????????????????

??????????????

?

????2????????????????????????

????2??????????????????????????

?

????????????SEX????????????????

?

??????????????????????????????

????????????????SEX??????????????

?

???????????????????????????????????

?

2

?

??????????????????SEX?????????????????

?

?????????????????SEX???????

?

???????????????????????????????????

??????????????????????SEX????????

?

???????????????????????????????????????

?????????????????????????SEX????????????

????????????????????????????

?

????????????????????????????????

?

?????????????????????????????????????

??????????????????SEX????????

?

??????????????????????????????

??????????????????????????????

?

???????????????????????????

?

????????????????SEX?????????????????

????????????????????SEX??????????????????

??????????????????????????

?

?????????????????

?

??????????????

?????????????????????

???????????????????????

?

????????SEX????????????????????????????????

???????????????????????SEX??????????????

?

3

?

??????????????????????

?

?????????????????????????????????

??????????????????????????

?

?????????????????SEX???????????

??????????????????????????????????

?

???????????????????????99%????????

????????????????????????????????????

?

???????? ???????????????????????????

?????????????SEX?????????????????????????????

?

??????????????????????????

?

????????????????????????????????

??????????????????????????????????????????????

??????????????SEX?????????????

?

????????????????????????????SEX??????????

?????????????????????????????????

?

???????????????????????????SEX?????????????

?

4

?

??????????????????

?

??????????????SEX?????????????

?

??????????????????????????SEX?????

?????????????????????SEX???????????

?

???????????????????????????????????????????

?

?????????????SEX????????????

?

??????????????????????????????????????????

????????????SEX?????????????

?

???????????????????????????????

?

???????????????????????????????????

??????????????????????????????

?

???????????????????????????????

???????????????SEX???????????????

?

?

13

????????????????

?

???????????????????????2?????????????

???????????????????? ????????????????????

????????????????????

?

???????????????????????????????????????????????????

???????????????????????????????????????

?

??????????????????????????????????????????????

?

????????1???????????2????????????????3???????????????

???????????????????????????????????????????????????

????????????????????????????????????????????????

????????????????????????

?

????????????????????????????????????

??????????????????????????????

?

???????????????????????????????? ????????????????

?????????????????????????????????????????

?

????????????????????????????????

?????????????????????????????????????????

?????????????????????????????????

?

???????????????????????????????????????

???????????????????????????????????????

?????????????????????????

?

???????????????????????

?

??????????????????

?

???????????????????????????????

????????????????????????????????????????

?

?????????

?

????????????????????????????????????????????????

?????????????????????????????????

??????????????????????????????

?

7

???????????????SEX??????????????????????????????

?

?

14

?

????????????????????????????????????

?

????????????????????????????????????????????????

?????????????????

?

?????????????

?

????2?????????

????2?????????????

????2??????????

????2?????SEX?????????

?

?????????????????????????????

?

???????????????????????????????????? ??????

?????????????????????????

?????????????????????????????????

?

????????????????????????????????????

?

????????????????????????????????????

????????????????????

?

?????????????????????????????????????????????SEX????

?????????????????

?

????????????????????????????????????

?

???????????????

?

???????????????????????????????????

?

??????????????????????

?

??????????????????????????????????????????????

????????????????????????????????SEX???????????

????????????????????????????????????????????????

?

?

?????????????????????????????????????????????

?

?????????

?

??????????????????

?

???????????????????????????????? ???????????????

?

?????????????????????????????????? ???????????????

?

?????????????????????????SEX?????????????

???????????????????????????????????????????

?

??????????????????????????????????????

?

?????????????????????????????????????????
????????????????????????????????????????
?????????????????????

?

a

?

????????????????????????

?

????2?????????????????SEX???????????????????

????2????????????????????????????????????????

????2?????????SEX?????????????????????

????2???????????????????????????????????????????

????2??????????????????SEX?????????

????2????????????????????SEX?????????????????

????2??????????????????SEX???????????

????21???????????????????????????????????????

????2???????????????????????????????????SEX???????????

?

?????????

?

???????????????????????????

????????????????????????SEX?????????????????????

?

?

?

???????????????????????????????????

?????????????????

?

????8??????????????????????????????

?????????????????????

?

???????????????????

????????????????????????

?????????????????????

?

????????????

?

????????????????????????????????????

?????????????????????????

?

???????????????????????????????? ???????????????

?

c

?

5

?

?????????????10??6??????????????????????????

?

???????????????????????????SEX???????????????

??????? ?????????????

?

?????????????

??????????????????????????5???????????

?

???????5 : ???????????????

???????4 : ????????SEX????

???????3 : ???????????????????????

???????2 : ????????????

???????1 : ??????????????????????

?

???????????????????1??5????????????????????

?

???????????????????????????5???????1??????

?????????????????????????????????????

??????????????????????

?

????????????????

?

??????????????????????????????

???????1????

?

????????????????

????????????

?

?????????????????????

?

???????????????????????????????????????????????????

?????????????????????????????3???????????????????????

?

?????????????????????????????????

?

?????????????

?

???????????????????????????????????????????

??????????????????????????????3???????????

?

??????3??????????????????????????????????????????

???????OK?????????????????????

?

????????????????????????????????????????

???????SEX???????????

?

??????????????????????????????????????????

??????????????????????????????????????

?

???????????????????????????????????????

?

?

7

?

????SEX???????????????????????????????????????

??????????????

?

????2???????????

????2????????????????

?

??????????????????

?

???????????????????????????????

?

??????????????????????????????????????????????

?

?????????????

?

????????????????????????????????????????????????

?????????????????????????????????????????????????????

?

?

8

?

???????????????????????????????????????????

?

??????????????????????????????????100%???????

??????????????????????????????????

?

?????????????????????????????????

???????????????????

?

??????????

???????????????????????

?

????2????????

????2?????????????????

?

???????????????

?????????????????????????????????????????

?

?????????

?

??????????????????????????????????????????

?

?????????

?

?????????????????

???????????????????

???????????????????

????????????????

?

????????????????????????????????

?

?

9

?

????????????????????

?

????2SEX??????????

????2?????????????????

?

?????????????????????????

?

???????????????????????????????????????

??????????????????????????????

?

?????????????????????????????SEX???????????????????

??????????????????????????????????????????????????

?

????????????????????????

?

????????????????????

?

4

?????????????????????????????????????

???????????????????????????????????????????

??????????????????????????8?????????????????????

???????????????SEX????????????????????

?

?

?

???????????????????????????????? ???????????

????????????????????????????????????

?

????2???????????

????2???????????

????2???????

????2??????

????2???????

????2???????????

?

?????????????????????????????

????????????????SEX??????????????????????

?

?

?

11

?

????1. ??????????????????????????????????

????2. ????????????????????????H???????

????3. ???????????OK???????????

????4. ????7????????????????????????????????????

????5. ??????????????????????????????????????????

?

12

?

????6. ?????????????????

????7. ???????????????????????????

?

13

?

????8. ?????????????????????????????
??????????????????????

????9. ?????????????????????????????????????
??????????????????????????????

????10. ??????????????????????

????11. ??????????????????????????

????12. ???????????????????????
?????????????????????????
???????????????????????????????

?

14

?

????13. ????????????????????????????????????????
??????????????????????????????????????????????
??????????????????????????????

?

15

?

????14. ???????????
??????????????????????????????????????????
??????????????????

?

??????????????????????????????????????????????
???????????????????????SEX???????????????????????

?

?

e

?

????????????????????????????????????????

??????????????

?

?????????????????SEX??????????????

?

????????????????????

?

????2?????????????????SEX???????????????????

????2????????????????????????????????????????

????2?????????SEX????????????????

????2????????????????????????????

????2??????????????????SEX??????????????

????2???????????????????????????????SEX?????????????

????2?????????SEX?????????

????21???????????????????????????????????????

????2???????????????????????????????????SEX???????????

?

???????????????????????

11

???????????????????????????

???????????????????????????????????

13

????????

??????????????????????????
??????????????????????????




???????????????????????
???????????????????????????????????????
???????????????????

????

????????????????

?

?
?????????????

?

????2????????????????SEX???????????????????????????
????????????????????????????

????2??????????????????SEX????????????

??????????????????????

?

??????????????????????????????????

?????????????????????????????????

??????????????????????????????

?????????????????????????????????????????????????

?

????????????????????????????????????????

????????????????????????????

?

??????????????????????

??????????????????????

?

???????????????????????????????????

?

???????????????????????????????????????

???????????????180????????

?

?

???????????????

?

?

?

?

Categories: DITA

Driving Hadoop data integration with standards-based models instead of code

bobdc.blog - Fri, 2015-02-13 18:43
RDFS models! Bob DuCharme http://www.snee.com/bobdc.blog
Categories: DITA

Gilbane Advisor 2.2.15 – Groundhog Day Edition

Scroll down to check out our new community section The Sharing Economy isn’t About Sharing at All It just seemed that way to some because of the overreach of “social”. It’s about access and convenience, not community. The access economy is changing the structure of a variety of industries, and a new understanding of the consumer […]

This post originally published on %%http://gilbane.com%%

Categories: DITA

Gilbane Conference Advisor 2.2.15 – Groundhog Day Edition

Scroll down to check out our new community section The Sharing Economy isn’t About Sharing at All It just seemed that way to some because of the overreach of “social”. It’s about access and convenience, not community. The access economy is changing the structure of a variety of industries, and a new understanding of the consumer […]

This post originally published on %%http://gilbane.com%%

Categories: DITA

Deep Data Dive into Supporting Developers

JustWriteClick - Sun, 2015-02-01 07:49

Here at Rackspace, we watch several sources to determine if a developer is having trouble with Rackspace Cloud services, many of which are based on OpenStack. We even have a notification tool, aptly named peril, that offers an aggregation of the many sites where developers may seek help. I’ve been on the Rackspace developer experience team since the very early days when we started supporting developers at the code level a few years ago. We monitor stackoverflow.com, serverfault.com, and superuser.com for questions tagged with Rackspace, rackspace-cloud, fog, cloudfiles, jclouds, pyrax, or keystone. At Rackspace we have been supporting cross-cloud SDKs such as Apache jclouds, Node.js pkgcloud, Ruby Fog, Python Pyrax, .NET, and PHP. Let’s look at the data from these many places to find out the patterns for application development.

A developer is in peril!

We have a group email address that we monitor for developer support requests. In the last year, about 6.25% of support requests came in through email. We saw nearly half of support requests on the jclouds bug list (JIRA tracker) and a community forum at community.rackspace.com. Tracking Github issues on our supported SDKs was another 40% with the 14% remaining support requests coming from Stack Overflow, where we track certain tags on questions asked. Here’s a screenshot showing what our notifications look like in a Slack channel internally. I like how it cycles through various alert messages, “Heads up, incoming!” and not shown is “BWEEEEEP BWEEEEP BWEEEEP” which naturally makes us want to help!

Peril example
True story: sometimes our slurps catch and notify before our email server. We are on it!

Documentation comments

If you’ve read my blog for a while or my book, you know I appreciate documentation that offers back-and-forth discussion in comment threads. We use Disqus comments for developer documentation at Rackspace. These comments tend to uncover three categories of requests:

  • Request for help when something doesn’t work as expected
  • Request for a feature that doesn’t exist
  • Request for correction: pointing out typos or incorrect formatting, such as JSON examples that lose their indentation

We see about 20 comments a month on API docs spanning all our products, with about 27.5% on Cloud Files (Object Storage), about 20% Cloud Servers (Compute), and Identity coming in third at 12%. In OpenStack docs, we have a doc bug link that serves for the third type of comment — pointing out a doc bug — but not on the API reference, yet. One pattern we see that’s comparable to a review of the document is someone asking a bunch of questions at once to gain understanding.

Stack Exchange sites

Stack Exchange sites are question and answer sites with built-in features to boost motivations for answering questions posted by others. Some examples sites include Stack Overflow for developers and Server Fault for administrators.

We track these tags on Stack Overflow with our peril tool:

rackspace rackspace-cloud fog cloudfiles jclouds pyrax keystone

When people don’t get a satisfactory answer on Stack Overflow, one interesting pattern is that they come to ask.openstack.org, the OpenStack open source equivalent site.

The Stack Exchange API is a ton of fun to scrape data. I wrote some Python scripts that request data from these calls, using the tag “openstack”:

  • Top Answerers: Matt Joyce, Everett Toews, and Lorin Hochstein are great at answering questions on Stack Overflow, and since Everett’s on the developer support team at Rackspace that makes sense.
  • Related Tags: openstack-nova, cloud, python are the top three related tags for openstack on Stack Overflow.
  • Top Tags: python, ruby, csharp/.net, php, javascript(node.js). One interesting observation is that overarching concepts like security and networking were often tagged along with the language itself.
  • Frequently Asked Questions: It’s not surprising that authentication is the root of the most frequently asked questions. Networking is also particularly complex and it shows in the number of questions asked. What was interesting though is the number of questions about monitoring and metrics on the cloud consumption itself.
  • Unanswered Questions: For the openstack tag, the unanswered questions had less than 100 views, compared to over 1000 views for the answered questions.

While your browser automatically decompresses the results when you enter http://api.stackexchange.com/2.2/tags/openstack/top-answerers/all_time?site=stackoverflow in your browser, I had to figure out how to have Python unzip the results and put them into JSON. Then I got stuck trying to automate putting the JSON into CSV, so I used konklone.io/json/ to convert the JSON to CSV.

Once I had the CSV files, I could use Tableau to get interesting data visualizations like a bubble grouping for related tags showing the frequency of the tags.

Tag bubbles

Github data

I found that Github issues were a great place to dive into the use cases for particular software development kits. I even discovered that our Austin-based real estate agent’s web site was developed by Rackspace Cloud php-opencloud users!

TryStack

One extremely helpful sandbox for trying OpenStack services through API use is Trystack, with over 15,000 users and growing every year. I find it very helpful to have my own sandbox besides the Rackspace Cloud to test the actual API calls and see what is returned from OpenStack. In looking at the logs, I found many queries about quotas which also explain the many questions about policies. It’s a free, community-donated cloud, and support is entirely through a Facebook group, so it’s a bit unusual but I still found interesting data around it.

Other findings

I found that many of the SDKs do not yet have full support for certain OpenStack services. For example, jclouds, the Java multi-cloud toolkit has a lot of users but doesn’t yet support the newest OpenStack services like Orchestration (heat templates), the Metering module ceilometer, the new versions of APIs for Images and Identity, and the latest storage policies implementation for Object Storage.

I also surmise that the service catalog coming through the Identity service needs stricter documentation and expectations setting. So the OpenStack API Working Group is tackling that issue by first discovering all the common patterns for the service catalog. Feel free to join the OpenStack API Working Group and review the incoming suggestions for consistency going forward or review patches going into OpenStack services that affect APIs.

Presentation

You can get the full presentation from slideshare.net, or watch me give it on YouTube.

Categories: DITA

Gilbane Advisor 1.20.15

Don’t Try to Be a Publisher and a Platform at the Same Time Or at least think it through very carefully. Also, do you really want to be called a “platisher”? Making these hybrids work over the long term is difficult, because their incentives work against each other. Toward the end of last year, one […]

This post originally published on %%http://gilbane.com%%

Categories: DITA
XML.org Focus Areas: BPEL | DITA | ebXML | IDtrust | OpenDocument | SAML | UBL | UDDI
OASIS sites: OASIS | Cover Pages | XML.org | AMQP | CGM Open | eGov | Emergency | IDtrust | LegalXML | Open CSA | OSLC | WS-I