Michael and all,
Good feedback! I will give it some attention this weekend and have something ready for our call.
Best,
Carlos
--- Carlos Evia, Ph.D. Director of Professional and Technical Writing Associate Professor of Technical Communication Department of English Center for Human-Computer Interaction Virginia Tech Blacksburg, VA 24061-0112 (540)200-8201
My first thoughts - and thanks so much
for pulling this together!How about this as a logic flow - trying
to keep it mostly one stream, with skippable sections, rather than completely
different branches. Assumptions: I think we're going after
an audience that is already somewhat aware of LW DITA, and considering
using it - those are the ones who can answer the questions we have. If
we go after too broad an audience we'll just confuse them, and get unhelpful
answers.1. Are you familiar with Lightweight
DITA? yes
- skip background no
- offer background (minimal, with links to more, and the suggestion that
they should consider reviewing that material and then coming back)2. Is your organization using DITA of
any kind today? yes
- give list of roles for selection
for each role selected, give option of providing
up to 3 example URLs, with a field for the submitter to describe the content
type
eg: Type of content: ---- URL for example,
if available: ----
(note: non-technical sme shouldn't give marketing
as an example since that's an explicit role - how about accountant?) no
- go to next question3. Where are you considering using LW
DITA? list
of roles again, again for each role have option of providing 3 content
types and example urls4. For the content you are considering
LW DITA for, what authoring tools do you use today? (should
include XML editors, web cms forms)5. Are you a tools developer? yes
- what formats do you need to accept as input?
(markdown, json, html, word, etc.)
and what formats do you need to provide as
output?
(above plus pdf, epub, etc.) no
- go to next question6. Are you familiar with DITA specialization? yes
- skip to next question no
- give background7. Are you familiar with LW DITA specialization? yes
- skip to next question no
- give background6. The following elements in LW DITA
provide the basic building blocks of content - more specialized forms of
them can be created by the user through specialization. Is there anything
missing from the basic list? note:
pre is for preformatted text, not prereqs7. If we removed the following specialization
capabilities from LW DITA, would it prevent your adoption? if
yes: (needs
to be multiple select) -
nestable containers (the div element in full DITA) -
attribute specializations off of base (any attributes that aren't metadata/props
based) -
specialization from existing specializations (any specialization that isn't
directly derived from topic and its elements) -
you've already removed a feature I need (write in) if
no (choice): -
I'm not planning to specialize -
or everything is fine, don't need those features8. Given what you currently know about
LW DITA, which of these potential benefits are important to you? (list)9. Can we contact you with follow up?
One final thing - if we can add the
ability to page back/forward in the survey, would make it easier to revisit
earlier answers (and to review it :-)Thanks again Carlos, Michael Priestley, Senior Technical Staff Member (STSM) Enterprise Content Technology Strategist mpriestl@ca.ibm.comFrom:
Carlos Evia <cevia@vt.edu>To:
dita-lightweight-dita@lists.oasis-open.orgDate:
06/30/2016 02:40 PMSubject:
[dita-lightweight-dita]
First draft of surveySent by:
<dita-lightweight-dita@lists.oasis-open.org> Ok dear LwDITA/FINCH/MAGMA2/LITA sub-comittee friends,Here’s a link to the first draft of our survey:https://virginiatech.qualtrics.com/SE/?SID=SV_8k8wxUJxNB3ZcEJFollowing Jang’s recommendation, the survey has two branches
based on the participant’s knowledge/awareness of DITA. There are gaps
in language and terminology, of course, but that happens in first drafts.Please send comments and feedback.Best,Carlos--- Carlos Evia, Ph.D.Director of Professional and
Technical WritingAssociate Professor of Technical
CommunicationDepartment of EnglishCenter for Human-Computer InteractionVirginia TechBlacksburg, VA 24061-0112(540)200-8201
|