Oops - now, which thread did I *really* intend this reply (below) for?
Can't spot it.
deb
--- In scrumdevelopment@yahoogroups.com, "Deb" <deborah@h...> wrote:
>
> Recent discussion with a tech-writer friend suggests to me that
> well-designed use of a CMS system for documentation could make
> documentation refactoring less onerous.
> Anyone know more about this?
> deb
>
> --- In scrumdevelopment@yahoogroups.com, corellan@j... wrote:
> >
> > Hi All,
> >
> > It's been a while since I subscribed to this mailing list and I
> think it's
> > time to introduce myself.
> >
> > My name is Christian Orellana, I have an Engineering Degree in
Computer
> > Science and about 12 years developing software, my first experience
> with the
> > Agile processes was when I used to work in the Motorola Global
> Software Group ....
Recent discussion with a tech-writer friend suggests to me that well-designed use of a CMS system for documentation could make documentation refactoring less...
Deb, Regardless of the genesis for the comment, I was very intrigued by your subject line. I hit Google and the phrase "emergent documentation" came up pretty...
Long time ago I was working on a project development based on EIFFEL (an OO language). If I am not wrong the develop environment (debbuger, compiler and so on...
I'm waiting to hear back from my tech writer friend. In the meantime, I'll tell you what sparked my post. The way she talked about using a CMS sounded rather...
Hi Deb, Have you looked at FitNesse? It's the wiki wrapper for the FIT (Framework for Integration) tool invented by Ward Cunningham (he and Rick Mugridge...
Pam, Deb, et al I was hoping this thread would go a bit longer. I was also hoping that someone would have some out-of-the-box ideas or experiences with ...
... In many ways, video is a hassle. It's big, it's noisy, you can't really find what you need most of the time. Recording it takes setup, new hardware, etc....
... Big and noisy seems to be the prevailing opinion of video in general. Everyone seems to have a mental image of a director, a megaphone, a camera crew and...
I've always wanted to make an audio recording of the decision making process while coding and have the audio available from within the source. I would only use...
Hi Vic. I went trolling for input on other lists and got lucky. I found a tech writer who knows how to use XML-based CMS with Agile! I'll meet her this...
I can't see video or audio being useful without transcripts. life is too short to process all that in real time - give me something searchable I can dip into....
... Well that is when you call Autonomy, spend 100_000 Euro and buy their software to analyse and transcribe Audio and Video into searchable text. -d...
Deb, Dave Deb - I don't think its just you. I have the same reaction - and a lot of people I have spoken with have a similar reaction. Part of that may be...
Hi Vic, nice to this approach, we use techniques for UAT and defect reporting with our clients, when face2face or direct collaboration <technology based> is...
Oops, told ya I needed caffeine.. seems I am breaking new ground in agile email, ignore words and grammar as part of minimal documentation rules maybe… Now...
Scott, I think you may have found the answer. Just train every dev in stenography <http://en.wikipedia.org/wiki/Stenotype>. :-) Vic ... -- Vic Uzumeri, PhD ...
... Scott, Your point may help to answer Deb's concern. If video clips like the one I posted can be made spontaneously and stored effortlessly (I'm thinking of...
Hi again, let me explain a little better, coffee is hitting home, We use video because it saves communication time and clarity, and we do not limit the time,...
Hi folks. This thread went silent weeks ago, but I've not been idle. I did some research and happily discovered an expert in my own hometown! So, while on...
Hi everyone! Nice to virutally meet you all! Following Deborah's thread, here is a quick overview of the approach we use to documentation, It's all based on...
Hi Steven, Here are my comments/answers to your questions, I hope you find them useful. ... I have not tried integrating javadoc into a dita project yet...
Hi Steven, Here are my comments/answers to your questions, I hope you find them useful. ... I have not tried integrating javadoc into a dita project yet...
... A nice article to read is http://xml.coverpages.org/dita.html Personally I do not like the XML approach, but that is a very well done article on DITA XML ...