[dojo-contributors] ReST Documentation

Chris Mitchell ccmitchellusa at gmail.com
Fri Jun 16 21:59:26 EDT 2006


Has anyone looked at emitting Eclipse help format as one possible output
format for the doc tool?  The format is *very* simple, and putting dojo docs
into this format would help with packaging dojo within that tool
environment, as well as benefit commercial and open source Eclipse tool
platform vendors and that are creating JS/CSS/XML and AJAX tools that will
need to work well with dojo (JS Eclipse, ATF, Rational, etc.).  In IBM, we
also use the Eclipse help format format for all the Info-center online
content hosted off our website.


On 6/15/06, Neil Roberts <neil at onebahamas.com> wrote:
> This has been the topic of discussion for the last two weeks. It, of
> course, is being worked on. The reason you can't run it locally right
> now is because of the huge backlash against the large number of
> files. When the Doc Tool is fully usable, I'll create a local version
> of the tool that will use fewer, larger files.
> The Doc Tool is running at http://dojotoolkit.org/~pottedmeat/dojo/
> docscripts/doctool.html and is still under development, but is not
> too far away from being usable.
> -Neil
> On Jun 14, 2006, at 2:34 PM, Jon Sykes wrote:
> > I'm just curious about the status of the API docs.  I was playing
> > around with the docs directory in the SVN checkout, but I couldn't
> > get anything to render anything of use.
> >
> > Is this stuff ready yet?  Any time scales?
> >
> > I think it would be so valuable to setup even just an API glossary
> > where there is just a list of all the functions available in the
> > entire library.
> >
> > Even now I find myself doing project searches for random words, in
> > an attempt to make sure Dojo doesn't already have something, before
> > I code it.
> >
> > Any thoughts?
> >
> > Jon Sykes
> >
> >
> > On Jun 7, 2006, at 8:30 PM, Dustin Machi wrote:
> >
> >> Perhaps we should just be hosting your documentation tools here?
> >> Or could you perhaps clarifiy how they will be different.  IIRC,
> >> we'll have our dojo doc widgets that parse json files to display
> >> api information, and then there is also wiki contributed
> >> information that is linked in with the tools.  While I know that
> >> we have been making it so that the dojo doc tools will work from
> >> localhost, we also need to host them live somewhere....is this
> >> what will go at manual.dojotoolkit.org? Or is this only the wiki
> >> portion of that information?
> >
> > _______________________________________________
> > dojo-contributors mailing list
> > dojo-contributors at dojotoolkit.org
> > http://dojotoolkit.org/mailman/listinfo/dojo-contributors
> >
> _______________________________________________
> dojo-contributors mailing list
> dojo-contributors at dojotoolkit.org
> http://dojotoolkit.org/mailman/listinfo/dojo-contributors
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://mail.dojotoolkit.org/pipermail/dojo-contributors/attachments/20060616/7c4c64a1/attachment.htm 

More information about the dojo-contributors mailing list