On 02/05/2015 06:20 PM, Matthew Farina wrote:
> I'd like to step back for a moment as to the purpose of different kinds
> of documentation. Sphinx is great and it provides some forms of
> documentation. But, why do we document methods, classes, or functions in
> python? Should we drop that and rely
On 02/05/2015 07:26 PM, Michael Krotscheck wrote:
> On Thu Feb 05 2015 at 12:07:01 AM Radomir Dopieralski
> mailto:openst...@sheep.art.pl>> wrote:
>
>
> Plus, the documentation generator that we are using already, Sphinx,
> supports JavaScript perfectly fine, so I see no reason to add
>
or
JavaScript files.
Aaron D. Sahlin
IBMUSM07(asahlin)
Dept. X2WA
Phone 507-253-7349 Tie 553-7349
From: Matthew Farina
To: "OpenStack Development Mailing List (not for usage questions)"
Date: 02/05/2015 11:29 AM
Subject: Re: [openstack-dev] [horizon] JavaScript docs?
On 2015-02-05 10:19:39 -0800 (-0800), Matthew Farina wrote:
[...]
> Can we have that system parse and use JSDoc? I'd like it to be
> useful to both JS devs and the doc generation toolchain.
A quick Web search turned up
https://github.com/debrouwere/jsdoc-for-sphinx and
https://github.com/juhamust/
On Thu Feb 05 2015 at 12:07:01 AM Radomir Dopieralski <
openst...@sheep.art.pl> wrote:
>
> Plus, the documentation generator that we are using already, Sphinx,
> supports JavaScript perfectly fine, so I see no reason to add another tool.
>
Try to empathize with us a little here. What you're askin
Ah, I had forgotten about the python module documentation. Sorry about that
and thanks for pointing it out.
Can we have that system parse and use JSDoc? I'd like it to be useful to
both JS devs and the doc generation toolchain.
On Thu, Feb 5, 2015 at 9:42 AM, Jeremy Stanley wrote:
> On 2015-02-
On 2015-02-05 09:20:35 -0800 (-0800), Matthew Farina wrote:
[...]
> But, why do we document methods, classes, or functions in python?
> Should we drop that and rely on Sphinx? I don't think anyone would
> argue for that.
[...]
Particularly since Sphinx collects the method/class/function
docstrings
I'd like to step back for a moment as to the purpose of different kinds of
documentation. Sphinx is great and it provides some forms of documentation.
But, why do we document methods, classes, or functions in python? Should we
drop that and rely on Sphinx? I don't think anyone would argue for that.
On 02/05/2015 11:04 AM, Radomir Dopieralski wrote:
> Plus, the documentation generator that we are using already, Sphinx,
> supports JavaScript perfectly fine, so I see no reason to add another
tool.
I agree with Radomir, why we can't just use Sphinx?
__
On 02/05/2015 10:27 AM, Anton Zemlyanov wrote:
> JSDoc (ngdoc) is good thing. It allows to describe files, functions and
> it's parameters, constructors, classes in case of ES6.
As does Sphinx.
> The problem is it tends to diverge with reality. The code is being fixed
> and evolved, but comments
JSDoc (ngdoc) is good thing. It allows to describe files, functions and
it's parameters, constructors, classes in case of ES6.
The problem is it tends to diverge with reality. The code is being fixed
and evolved, but comments are often not updated (who want to do much more
work)? And JSDoc generat
On 02/04/2015 06:06 PM, Thai Q Tran wrote:
> As we're moving toward Angular, might make sense for us to adopt ngdoc
> as well.
I don't think it makes much sense. We don't have any style guide for the
JavaScript documentation simply because it's not needed. We don't really
have any for Python eithe
t: Wednesday, February 4, 2015 4:00:17 PM
> Subject: Re: [openstack-dev] [horizon] JavaScript docs?
>
> On 02/04/2015 12:48 PM, Michael Krotscheck wrote:
> > I agree. StoryBoard's storyboard-webclient project has a lot of existing
> > code already that's pretty well
On 02/04/2015 12:48 PM, Michael Krotscheck wrote:
> I agree. StoryBoard's storyboard-webclient project has a lot of existing
> code already that's pretty well documented, but without knowing what
> documentation system we were going to settle on we never put any rule
> enforcement in place. If some
I agree. StoryBoard's storyboard-webclient project has a lot of existing
code already that's pretty well documented, but without knowing what
documentation system we were going to settle on we never put any rule
enforcement in place. If someone wants to take a stab at putting together a
javascript
As we're moving toward Angular, might make sense for us to adopt ngdoc as well.-Matthew Farina wrote: -To: "OpenStack Development Mailing List (not for usage questions)" From: Matthew Farina Date: 02/04/2015 05:42AMSubject: [openstack-dev] [horizon] _javascript_ docs?In python we have a st
16 matches
Mail list logo