[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: RE: [dita-adoption] RE: dita.xml.org was [dita-users] DITA Getting started
Hi JoAnn, Great ideas, both of them! Best Regards, >< Content Technologies ApS Steffen Frederiksen Director Katrinebjerg Science Park Aabogade 15 DK-8200 Aarhus N Mobile: +45-5155-3005 Fax: +45-6980-3578 srf@dita-exchange.com www.dita-exchange.com -----Original Message----- From: JoAnn Hackos [mailto:joann.hackos@comtech-serv.com] Sent: Wednesday, August 27, 2008 23:22 To: Tsao, Scott; David J. B. Hollis; Carol Geyer Cc: Kristen James Eberlein; Gershon Joseph; Bob Thomas; Brenda Oakley; dita-adoption@lists.oasis-open.org Subject: [dita-adoption] RE: dita.xml.org was [dita-users] DITA Getting started Hi Folks, I'm forwarding this note to the DITA TC members in general. I think we should do a presentation on the dita.xml.org site at the next meeting. I also want to do a round of introductions for everyone to get to know everyone else's background. Kris, Would you be able to do the dita.xml.org review, perhaps with help from Carol and Su-Laine? Gershon, What do you think? We're moving ahead so quickly that we really haven't had an opportunity to proceed carefully. Thanks, JoAnn -----Original Message----- From: Tsao, Scott [mailto:scott.tsao@boeing.com] Sent: Tuesday, August 26, 2008 11:12 AM To: David J. B. Hollis; Carol Geyer Cc: Kristen James Eberlein; Gershon Joseph; Bob Thomas; Brenda Oakley; JoAnn Hackos Subject: RE: dita.xml.org was [dita-users] DITA Getting started David, I agree that the first four questions will be very useful for novice users like me, and they should also be included as the topics to cover in an upcoming webinar as I suggested in our last meeting. Thanks, Scott Tsao Associate Technical Fellow The Boeing Company -----Original Message----- From: David J. B. Hollis [mailto:dhollis@AandOConsultancy.ltd.uk] Sent: Friday, August 22, 2008 9:47 AM To: Carol Geyer Cc: 'Kristen James Eberlein'; 'Gershon Joseph'; Tsao, Scott; 'Bob Thomas'; 'Brenda Oakley'; 'JoAnn Hackos' Subject: Re: dita.xml.org was [dita-users] DITA Getting started Hi, Carol Can I be a big nuisance?! ;-) I think I'm feeling much the same as I did with the Adoption TC a short while ago. Namely that I'm coming to this fairly fresh, whilst other folk are way ahead of me! I just don't feel I've got a proper 'handle' on the site. dita.xml.org seems to go back a number of years, at least I've certainly seen content from 2006, and I'm sure there's stuff older than that. Would it be possible to have a fairly brief top-level synopsis about the site? Which areas can site users access for editing, and which not? Which areas are relatively static, and which are forever changing? Which areas of the site address which needs? How can a site driven by a wide and diverse community be properly administered - correcting obvious mistakes. I think that would help me, at least. Would others find that useful? Many thanks, David > This feedback is very helpful. Never worry about being overly > critical. > Fresh eyes are great. > > 1. It's definitely possible to list the wiki topic headings in the > vertical nav. In fact, it would take me about 15 minutes. Can we > agree on what other things we want to keep or add in the vertical nav? > > 2. The explanation behind the 'Book' tag is kind of complicated. We > can discuss it on the next call. In the meantime, I'll see if we can > find a solution. > > 3. Fixing out-of-date pages is a never-ending job, but if we assign SC > members to oversee portions of the site, we should be able to stay on > top of it much better. > > 4. I've asked our webmaster to teach me how to edit the tag list (it's > not intuitive). Once we remove the bloopers, the SC might want to > periodically review the tags and update as needed--or just assign that > job to one person. > > Looking forward to making progress, > Carol > > > -----Original Message----- > From: David J. B. Hollis [mailto:dhollis@AandOConsultancy.ltd.uk] > Sent: Friday, August 22, 2008 4:57 AM > To: Kristen James Eberlein; Gershon Joseph; Scott Tsao; Bob Thomas; > Carol Geyer; Brenda Oakley > Cc: JoAnn Hackos > Subject: Fwd: [dita-users] DITA Getting started > > Hi, All > > I noticed this on DITA-Users, and at first I was delighted that the > message is getting across. The page is also an excellent starting > point for adopting DITA. > > However, after a small amount of investigation, it does seem to > encapsulate the scope of the task ahead. For instance: > > 1. If I landed on the homepage for dita.ml.org, how would I navigate > to this page? There seems to be very little navigation built into the > site. I think the route would be either of these: > Browse - Categories : Introduction : Getting started Wiki > Knowledgebase (orange top line) : Setting up DITA : Getting started > > I think the topic headings in the Wiki Knowledgebase are great, and > wonder if it would be possible to bring some or all of them into the > 'Browse' listing? > > 2. I don't know what the 'book' sub-directory is supposed to contain, > but even it doesn't contain a link to the getting started page. > http://dita.xml.org/book/ > > 3. A little bit of browsing further, and I came across a few out of > date links: > http://dita.xml.org/uk-dita-user-group - the event has happened! > http://dita.xml.org/book/dita-ot-design-documents - out of date > information > > The first I've edited. The second I'm not sure about. I'm sure there > are many like this. > > 4. The Categories page is very peculiar, and there are a number of > howlers. 'en Français' and 'Kéroack' caught my attention. These appear > to be the same, and are a mis-placed blog posting. > > > I apologise if I'm being overly critical - I really don't want to > offend anyone. There's clearly a great deal on the site, and we > shouldn't underestimate the task ahead. > > I'm sorry if this puts anyone off, just as Kristen is trying to > recruit folks! ;-) > > David > > (I'm just waiting for someone to point out that my own site is > absolute rubbish, and completely out of date! "People in glass houses > ..... ") > > >> From: Paul Masalsky <paulmasalsky@yahoo.com> >> Date: 21 August 2008 14:11:03 BST >> To: dita-users@yahoogroups.com >> Subject: Re: [dita-users] DITA Getting started >> Reply-To: dita-users@yahoogroups.com >> >> Lately the place of choice for getting started has been: >> http://dita.xml.org/book/getting-started >> >> Paul Masalsky >> EMC >> >> Paul Masalsky - paulmasalsky@yahoo.com >> >> >> --- On Thu, 8/21/08, chaitra venkatesh <chaitra_babloo@yahoo.co.in> >> wrote: >> From: chaitra venkatesh <chaitra_babloo@yahoo.co.in> >> Subject: [dita-users] DITA Getting started >> To: dita-users@yahoogroups.com >> Date: Thursday, August 21, 2008, 5:16 AM >> >> Hi Folks, >> >> I am new to this Group and new to Dita also. >> How do I get started with Dita. >> Can I get some links or book references so that I can get some hang >> of it. >> It will be a great help for me. >> Thanks in advance. >> >> Regards, >> Chaitra > --------------------------------------------------------------------- To unsubscribe from this mail list, you must leave the OASIS TC that generates this mail. Follow this link to all your TCs in OASIS at: https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]