[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Review of Remaining "TBD Sections" on dita.xml.org
In summary: all items are out-of-date, and only a few are worth keeping/updating.
Setting up DITA
Getting started - information good, but needs to be updated; most external links are dead
Getting started as cheaply as possible - outdated; drop
Resources for Beginners - many links to external resources that no longer exist; a good idea that needs updating
Migrating legacy content - focus is on migrating content from Frame; rename and update(?)
Installing the DITA Open Toolkit - outdated; update
Setting up stylesheets and a publishing system - outdated; update
Setting up the Eclipse Help Infocenter for publishing DITA content - outdated, drop
About authoring tools - holds up; keep (but update)
About storing and managing content - update
File and folder naming - doesn't really address issue well; drop/replace
The DITA Open Toolkit
The DITA Open Toolkit - updated semi-recently (2013); keep (update)
Installing the DITA Open Toolkit - outdated; update
Installing OT on the Mac - can't comment if this is still valid; likely outdated
Publishing with the DITA Open Toolkit - updated semi-recently (2013); keep (update)
Plugins for the DITA Open Toolkit - updated semi-recently (2013); keep (update)
About Plugins - suggest this single-para piece just be added to revamped version of "Plugins for the DITA Open Toolkit"
Plans for future versions of the DITA Open Toolkit - outdated; drop
Plans for the DITA Open Toolkit PDF2 Plug-in - outdated; drop
DITA Community
List of organizations using DITA - useful but needs updating (several firms listed no longer exist); link to DITAWriter?
Examples of documents created in DITA - only avail to logged in users (why?); ought to link instead to samples on GitHub
List of speakers for DITA presentations - only two speakers listed, not a critical resource; drop
DITA user groups - mostly links to internal pages most of which date to late 2000s; update(?)
DITA Conferences - outdated (2008); update
Blogroll - update (do we keep ones that still exist but haven't updated since late 2000s?)
Testimonials for DITA 1.2 Implementation - consists of a single recommendation; drop
HAWEBS.NET - DITA Community (Simplified Chinese) - dead link; drop
DITA Standards Development
- in general all of the material in this section is outdated, but some pieces should be kept for archival purposes and others updated for DITA 1.3
Cheers!
Keith Schengili-Roberts
DITA Information Architect / DITA Specialist
IXIASOFT
825 Querbes, Suite 200, Montréal, Québec, Canada, H2V 3X1
tel + 1 514 279-4942 / toll free + 1 877 279-4942
cell + 1 647-472-7367
robertsk@ixiasoft.com / www.ixiasoft.com
________________________________________
From: dita-adoption@lists.oasis-open.org <dita-adoption@lists.oasis-open.org> on behalf of Dr. Stanley Doherty <stan@modularwriting.com>
Sent: Sunday, August 16, 2015 3:02 PM
To: dita-adoption@lists.oasis-open.org
Subject: [dita-adoption] Agenda: 08-17-2015 Adoption/TechComm Meeting
====================================================
DITA Adoption/TechComm SC Meeting Agenda
08-17-2015
12:00PM/EST
====================================================
CONNECTION INFORMATION
Meeting Number: 201240602
Meeting Password: ditatc
1. Go to https://cisco.webex.com/cisco/j.php?MTID=m8c33283eaac954cd8be7c2cb62abeae6
2. Enter the meeting password: ditatc
3. Click 'Join Now'.
4. Follow the instructions that appear on your screen.
(866) 432-9903 for the San Jose/Milpitas area
(866) 349-3520 for the RTP area.
To join the teleconference only:
1. Dial into Cisco WebEx (view all Global Access Numbers at
http://cisco.com/en/US/about/doing_business/conferencing/index.html)
2. Follow the prompts to enter the Meeting Number (listed above) or Access Code
followed by the # sign.
====================================================
A. Whitepapers
====================================================
1. Release management whitepaper
> AI/Bob-Keith: Release the whitepaper
2. Release management DITA-OT plug-in
> AI/Stan: test the most recent plug-in that Tom Cihak
uploaded and send an email to the ATC summarizing status
3. DITA 1.3 A-Z Whitepaper
> AI/Bob-Keith: Release the whitepaper
4. Scoped keys whitepaper
> ATC - Review by Friday, send comments to Leigh and to
the ATC list
> https://www.oasis-open.org/apps/org/workgroup/dita-adoption/download.php/56130/ScopedKeysFeatureArticle.pdf
5. Short description whitepaper
> ATC - Review by Friday, send comments to Joe and Keith.
> https://www.oasis-open.org/apps/org/workgroup/dita-adoption/download.php/56218/shortdesc_article.pdf
6. DITA 1.3 Learning and Training (Mark Myers,
Jennifer Gemmell; date not confirmed)
7. DITA 1.3 Scoped Keys Overview (Chris Nitchie;
date not confirmed)
8. Content Referencing Practices (Dawn Stevens;
date not confirmed)
9. XML mention (Israel Gale)
10. URI-Key Migration
AI/Stan: Organize a meeting with Les, Pat, et
all to troubleshoot the issues they encountered?
====================================================
B. Discussions
====================================================
1. DITA SWOT (Strengths, weaknesses, opportunities, threats) wiki
> https://wiki.oasis-open.org/dita-adoption/DITA_Adoption_SWOT_Analysis
a. "Why choose not to move to DITA?"
> Capture the top ten reasons companies and departments
ultimately decide NOT to
> Correlate these reasons with the CIDM survey results on
DITA productivity
- https://www.infomanagementcenter.com/wp-content/uploads/2014/10/BP2014-12JHackos.pdf
b. How NOT to get trapped early in your implementation.
> Example - do topic typing from day-1
> Example - have story about interoperating with company
wikis (Confluence, MindTouch)
2. Discussion: DITA worst practices:
> https://wiki.oasis-open.org/dita-adoption/DITA_Worst_Practices
3. Discussion: DITA Getting Started
> https://wiki.oasis-open.org/dita-adoption/DITA_Getting_Started
====================================================
C. dita.xml.org
====================================================
1. Action items:
> AI/Keith: Review the remaining TBD sections of the
dita.xml.org Knowledgebase.
> AI/Bob: Run a site scraping tool against all the
on dita.xml.org to build a repository of its
contents.
> AI/Stan: Dig out his slides on "top reasons" NOT to move
to DITA and forward to the ATC list.
2. Content triage (ongoing) the existing dita.xml.org content to determine
whether articles there should be:
a. Removed eventually
b. Preserved
c. Revised and re-integrated
d. Replaced with something else
TOC signups:
- http://dita.xml.org/book/dita-wiki-knowledgebase
- Reviewer Chapter Title
------------------------ --------------------------------
JoAnn Hackos Capabilities of DITA
TBD Setting up DITA
Stan Doherty Working with DITA
- See email to ATC list
TBD The DITA Open Toolkit
TBD DITA Community
Keith Schengili-Roberts The Business Case for DITA
- See email to ATC list
M. Priestly/A. Swope The DITA Maturity Model
- Don has a DITA-sourced version
Bob Thomas DITA Specializations Development
- See email to ATC list
TBD DITA Standards Development
2. Summary comments - dita.xml.org review
> Much of the content there is sparsely written, outdated, or
irrelevant to DITA 1.3 users.
> ATC attendees converged on the opinion that moving ahead
with the current outline would not be wise.
> ATC attendees proposed a bottom-up approach to reorganizing
the site ... starting with audience analysis.
3. Audience analysis brainstorming - dita.xml.org review
> Specify audience types in the actual articles
> Revisit the audience profiles at the next meeting
a. Newbies (froshpeople) - just being exposed to DITA, quite probably
developing a business case or first prototypes for DITA
1) Newbie manager - wants information on previous business
cases, wants logic behind a migration
- Example - the Nokia business case
2) Newbie information architect - wants information about
design decisions, gotchas, et al.
3) Newbie writer - wants information about how to get
started with DITA
4) Newbie translation manager - wants information about
best practices and pitfalls
5) Newbie tech support professional or implementer - wants
information about tools configuration and basic
customization issues (including specialization)
b. First-year adopters (sophomores) - have been working in DITA
for a year and want to profile ROI and to assess
next-generation investment points.
> Reuse strategies
> Metadata investments
> New domain vocabularies
> Intrinsic XML benefits
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]