[Mulgara-general] ANN: Mulgara Documentation

[Gregg Reynolds]

On Mon, Nov 29, 2010 at 12:39 PM, Paul Gearon <gearon at ieee.org> wrote:

> On Mon, Nov 29, 2010 at 1:34 PM, Gregg Reynolds <dev at mobileink.com> wrote:
> > On Mon, Nov 29, 2010 at 11:04 AM, Paul Gearon <gearon at ieee.org> wrote:
>


> > The nice thing about DITA is that the topic-oriented structure makes it
> > quite easy to write an article on a single topic or subtopic (concept,
> > task/procedure, etc.) without worrying about where it fits in the overall
> > structure.  Hint, hint.
>
> Well, that makes it more like a wiki, right? The main problem with the
> wiki is trying to organize all that data that is added in an ad hoc
> manner. The main advantage is that it's easy to edit. But the only
> feature that *really* counts is people willing to do something with
> it, and since you've been putting the effort in, then I'm happy to
> work with you there.


That is an interesting question.  It is wiki-like, in a sense, but since it
has a controlled (but extensible) vocab I'm hoping sprawl would be less of a
problem.  At least that's what if felt like putting together the UG outline.
 But it's different in that it is easy to re-use and re-organize content,
which addresses a problem I've always had editing wikis where some info
needs to be available via a variety of access patterns.  But I'm pretty much
a beginner at DITA so the fancy stuff might have to wait.

For the near term, I'll be happy if I can come up with a more or less
complete outline for both a UG and a Dev Guide.  If anybody can think of
specific topics I've left out drop me a line or create an issue ticket at
Bitbucket.  E.g. I need to add a concept topic about the different kinds of
graph, and a task topic about getting administrative data and statistics.
 Not to mention something about legacy v. roadmap ("model" v. "graph", iTQL,
rmi, etc.).

Also, if you want to place a formatted copy of the UG on the Mulgara website
that's fine by me, although you might want to wait until it's a little more
fleshed out.

One question:  it looks like the Mulgara doc is forked from the Kowari doc,
which was under a GNU Free Doc license (
http://docs.mulgara.org/overview/history.html).  So I wonder if that means
the UG can use the stuff on the wiki and/or the old site under a CC license
or if the GNU license infects it.  Any idea?  Not that I much care, but it's
probably good to be clear about such stuff from the beginning.

-Gregg
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.mulgara.org/pipermail/mulgara-general/attachments/20101129/76e8b7e3/attachment.html>