dita-lightweight-dita message
[Date Prev]
| [Thread Prev]
| [Thread Next]
| [Date Next]
--
[Date Index]
| [Thread Index]
| [List Home]
Subject: Re: [dita-lightweight-dita] First draft of survey
- From: "Michael Priestley" <mpriestl@ca.ibm.com>
- To: Carlos Evia <cevia@vt.edu>
- Date: Fri, 22 Jul 2016 23:12:05 -0400
Looking good to me - just a couple of nits
on the logic, and input where requested on the authoring tools list:
- the first question ends the survey
rather abruptly for ignorants folks - maybe instead of a question we could
just have a preamble that says "this survey assumes a basic level
of knowledge of lwdita - you can find out more here, before taking the
survey, if interested -. if you are already familiar with lw dita, click
here to take the survey"
- the question on knowledge of specialization
didn't seem to trigger anything - I was still getting both specialization
questions regardless of my answer
- for the question on what authoring
tool they use today - here's my ten cents:
-
remove stone carving - it's a classic and will never go away, but not used
by our target audience
-
remove pencil and paper- that was a fad, we've all moved on
-
add PPT
-
add Excel
-
add inDesign
-
add "other" field
Michael Priestley, Senior Technical Staff Member (STSM)
Enterprise Content Technology Strategist
mpriestl@ca.ibm.com
From:
Carlos Evia <cevia@vt.edu>
To:
Michael Priestley/Toronto/IBM@IBMCA
Cc:
dita-lightweight-dita@lists.oasis-open.org
Date:
07/13/2016 02:37 PM
Subject:
Re: [dita-lightweight-dita]
First draft of survey
Sent by:
<dita-lightweight-dita@lists.oasis-open.org>
Dear all,
Here’s a new version of the LwDITA survey that incorporates
Michael’s comments:
https://virginiatech.qualtrics.com/SE/?SID=SV_8k8wxUJxNB3ZcEJ
I still have to create some of the background texts, but
I would love some feedback before I continue.
Thanks a lot!
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
On Jul 6, 2016, at 4:19 PM, Michael Priestley <mpriestl@ca.ibm.com>
wrote:
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 question
3. Where are you considering using LW DITA?
list of roles again, again for each role have
option of providing 3 content types and example urls
4. 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 question
6. Are you familiar with DITA specialization?
yes - skip to next question
no - give background
7. Are you familiar with LW DITA specialization?
yes - skip to next question
no - give background
6. 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 prereqs
7. 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 features
8. 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.com
From: Carlos
Evia <cevia@vt.edu>
To: dita-lightweight-dita@lists.oasis-open.org
Date: 06/30/2016
02:40 PM
Subject: [dita-lightweight-dita]
First draft of survey
Sent 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_8k8wxUJxNB3ZcEJ
Following 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 Writing
Associate Professor of Technical Communication
Department of English
Center for Human-Computer Interaction
Virginia Tech
Blacksburg, VA 24061-0112
(540)200-8201
[Date Prev]
| [Thread Prev]
| [Thread Next]
| [Date Next]
--
[Date Index]
| [Thread Index]
| [List Home]