Message from discussion
Documentação do JS
Received: by 10.50.213.101 with SMTP id nr5mr1793859igc.1.1327082213589;
Fri, 20 Jan 2012 09:56:53 -0800 (PST)
X-BeenThere: jspro@googlegroups.com
Received: by 10.231.29.8 with SMTP id o8ls3138401ibc.6.gmail; Fri, 20 Jan 2012
09:56:52 -0800 (PST)
Received: by 10.50.47.132 with SMTP id d4mr1830399ign.1.1327082212412;
Fri, 20 Jan 2012 09:56:52 -0800 (PST)
Received: by 10.50.47.132 with SMTP id d4mr1830398ign.1.1327082212401;
Fri, 20 Jan 2012 09:56:52 -0800 (PST)
Return-Path: <yuricam...@gmail.com>
Received: from mail-tul01m020-f169.google.com (mail-tul01m020-f169.google.com [209.85.214.169])
by gmr-mx.google.com with ESMTPS id cg4si9293399igb.0.2012.01.20.09.56.52
(version=TLSv1/SSLv3 cipher=OTHER);
Fri, 20 Jan 2012 09:56:52 -0800 (PST)
Received-SPF: pass (google.com: domain of yuricam...@gmail.com designates 209.85.214.169 as permitted sender) client-ip=209.85.214.169;
Authentication-Results: gmr-mx.google.com; spf=pass (google.com: domain of yuricam...@gmail.com designates 209.85.214.169 as permitted sender) smtp.mail=yuricam...@gmail.com; dkim=pass header...@gmail.com
Received: by mail-tul01m020-f169.google.com with SMTP id ta7so1297197obb.0
for <jspro@googlegroups.com>; Fri, 20 Jan 2012 09:56:52 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
d=gmail.com; s=gamma;
h=mime-version:in-reply-to:references:from:date:message-id:subject:to
:content-type:content-transfer-encoding;
bh=m+yhCFvvDBGddKpvsvH0A379/xHP8vlvRJoRgUgastg=;
b=AUEzAPHIb4O8f5L+Pj6BBJu50eykj08oRYMUrUkNcCoQ3leUvf6n4P3MEdJEf3RTjQ
L4oFpBCqt3CRp8TkMvI1i81UZ0jUYaRp/OFUA6UuDPmnu/ki2RYD/h9E95c3qmp36Dsm
QrnG67rQAWhfzD1g9Q2KUyYvWY8j2HWjFe3n8=
Received: by 10.182.1.8 with SMTP id 8mr27515385obi.11.1327082212255; Fri, 20
Jan 2012 09:56:52 -0800 (PST)
MIME-Version: 1.0
Received: by 10.182.13.38 with HTTP; Fri, 20 Jan 2012 09:56:11 -0800 (PST)
In-Reply-To: <63dcdaa6-3965-42a2-bbad-058334713bc7@4g2000pbw.googlegroups.com>
References: <CADGpeSxRnMYK=vpZP+MwvmbcGfnh8-RVUzMKWWPCu9NZyMP...@mail.gmail.com>
<CAH5u+X=UOfmTY7zs45-ctziBRKHge2SJA8R8m9OuH+au3YC...@mail.gmail.com>
<CADwYJLTVPmcrvfydBCyQJSdbYWbMqaACrY-6rkaFdg_Ybi4...@mail.gmail.com>
<CADGpeSyBrsJgfeuoiL76h9QKTJmmUx20M13dvdhH+9vB1eF...@mail.gmail.com>
<CADGpeSzP=B+YwxEUUX5AqgNpB0OZDWcUMLqF3h+MT_7KG-O...@mail.gmail.com> <63dcdaa6-3965-42a2-bbad-058334713...@4g2000pbw.googlegroups.com>
From: Yuri Camara <yuricam...@gmail.com>
Date: Fri, 20 Jan 2012 15:56:11 -0200
Message-ID: <CADGpeSymGwv3+dHr4OFjsaVxLEpRid72=hUJ7V-1NVpbkRq...@mail.gmail.com>
Subject: =?ISO-8859-1?Q?Re=3A_=5Bjspro=5D_Re=3A_Documenta=E7=E3o_do_JS?=
To: jspro@googlegroups.com
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable
Ol=E1 Bruno,
Essa eu n=E3o tinha visto. Vou dar uma olhada. Valeu!
N=E3o vi nenhuma que pude-se ser aplicado ao jQuery. O JSDoc que foi a
que mais me interessou por enquanto =E9 s=F3 pra JS Puro, por exemplo. E
de prefer=EAncia OO.
Quem quiser saber mais e usar:
http://code.google.com/p/jsdoc-toolkit/
(JSDoc Toolkit =E9 a ferramenta que gera a documenta=E7=E3o em HTML usando
como refer=EAncia os coment=E1rios que voc=EA fez em seu projeto na sintaxe
JSDoc.)
2012/1/20 Bruno Tavares <brunotavar...@gmail.com>:
> A respeito de documenta=E7=E3o de JS, s=F3 gostaria de acrescentar o JSDu=
ck:
>
> =A0 =A0 =A0https://github.com/senchalabs/jsduck
>
> Essa =E9 a engine usada para montar os docs do framework Ext JS e Sencha
> Touch.
>
> =A0 =A0 http://docs.sencha.com/ext-js/4-0/
>
> N=E3o sei direito como ele se aplica para JavaScript puro, ou usando
> jQuery e afins, mas vc pode testar.
>
> On Jan 20, 7:10=A0am, Yuri Camara <yuricam...@gmail.com> wrote:
>> Thiago e Bruno,
>>
>> Quando eu estudar melhor teste unit=E1rio eu vejo o esquema da
>> documenta=E7=E3o com ele. Foi bom saber que ele =E9 legal pra fazer tb.
>>
>> "S=F3 queria trocar ideia com que j=E1 faz para saber qual gosta mais e
>> tal." Troquem o "S=F3 queria" por "Gostaria de". Parece que estou
>> querendo excluir pessoas do papo, n=E9? rs! Conversa pela net tem essas.
>>
>> 2012/1/20 Yuri Camara <yuricam...@gmail.com>:
>>
>>
>>
>>
>>
>>
>>
>> > Este tipo de documenta=E7=E3o produzida a partir de coment=E1rios no c=
=F3digo
>> > como com jsdoc parece pouca falada. N=E3o vi nada a respeito em nenhum
>> > grupo de JS que procurei. Achei estas duas discuss=F5es num grupo de
>> > node.js:
>>
>> >https://mail.google.com/mail/#search/jsdoc/1338f0bcee60562f
>> >https://mail.google.com/mail/#search/jsdoc/134a91fc493cd0eb
>>
>> > Bom, eu vou adotar esta pr=E1tica pelo menos por enquanto. S=F3 queria
>> > trocar ideia com que j=E1 faz para saber qual gosta mais e tal.
>>
>> > 2012/1/20 Bruno Henrrique <squall.br...@gmail.com>:
>> >> Acho que os testes s=E3o uma=A0=F3tima=A0forma de documentar...
>> >> no client-side vc pode usar Jasmine=A0....^^
>>
>> >> 2012/1/20 Thiago Avelino <thiagoavelinos...@gmail.com>
>>
>> >>> Geralmente quando mexo com JS =E9 para server-side e escrevo teste u=
nitario,
>> >>> para mim eles server como documenta=E7=E3o...
>>
>> >>> []'s
>>
>> >>> --
>> >>> Thiago Avelino |www.avelino.us
>> >>> @avelino0
>>
>> >>> 2012/1/20 Yuri Camara <yuricam...@gmail.com>
>>
>> >>>> Bom dia pessoal,
>>
>> >>>> Vcs documentam seus c=F3digos JS? Estou estudando e come=E7ando a u=
sar o
>> >>>> JSDoc e estou achando bem interessante. O YUIDoc tamb=E9m parece bo=
m.
>>
>> >>>> Abs!
>>
>> >> --
>> >> Bruno Henrique(Garu)
>> >> @garuhenr