notes2-team Mailing List for Notes (Page 11)
Brought to you by:
andersonrb
You can subscribe to this list here.
2003 |
Jan
|
Feb
|
Mar
(11) |
Apr
(21) |
May
(57) |
Jun
(79) |
Jul
(76) |
Aug
(24) |
Sep
(58) |
Oct
(187) |
Nov
(134) |
Dec
(81) |
---|---|---|---|---|---|---|---|---|---|---|---|---|
2004 |
Jan
(30) |
Feb
(42) |
Mar
(60) |
Apr
(23) |
May
(6) |
Jun
(32) |
Jul
(14) |
Aug
(10) |
Sep
(6) |
Oct
(6) |
Nov
(4) |
Dec
(2) |
2005 |
Jan
|
Feb
|
Mar
|
Apr
|
May
|
Jun
|
Jul
|
Aug
|
Sep
|
Oct
(1) |
Nov
|
Dec
|
2006 |
Jan
|
Feb
(1) |
Mar
|
Apr
|
May
|
Jun
|
Jul
|
Aug
|
Sep
|
Oct
|
Nov
(6) |
Dec
(3) |
2007 |
Jan
(2) |
Feb
(2) |
Mar
|
Apr
(1) |
May
|
Jun
|
Jul
|
Aug
|
Sep
|
Oct
|
Nov
|
Dec
|
From: andreithomaz <and...@bo...> - 2003-12-22 04:21:50
|
me dei conta de algo: faltou a caixa de busca. o site vai ter este recurso, n=E9? andrei > Ol=E1 pessoal!! > > Faz um tempo que n=E3o escrevo para a lista. Andava meio atarefado.. > > Enfim, estou enviando o layout da p=E1gina do Notes > > Uma observa=E7=E3o: > > No layout da p=E1gina Equipe do Notes eu s=F3 coloquei algu ns nomes porque > muitos de voc=EA ainda n=E3o colocaram suas informa=E7=F5es em > http://notes2.sourceforge.net/mkt/wakka.php? wakka=3DSessaoSobreAEquipe > > > ------------------------------------------------------- -------------- > Allan Rodrigo > #Equipe do Notes - Coordena=E7=E3o de Marketing/Design > > -- > +++ GMX - die erste Adresse f=FCr Mail, Message, More +++ > Neu: Preissenkung f=FCr MMS und FreeMMS! http://www.gmx.n et > -- RGB Design Digital - Andrei R. Thomaz www.rgbdesigndigital.com.br __________________________________________________________________________ Acabe com aquelas janelinhas que pulam na sua tela. AntiPop-up UOL - =C9 gr=E1tis! http://antipopup.uol.com.br/ |
From: andreithomaz <and...@bo...> - 2003-12-22 04:19:45
|
ol=E1, minha =FAnica sugest=E3o para o layout, q eu gostei bastante: que os itens do menu fossem agrupados de forma l=F3gica (s=E3o muitos para serem listados todos juntos). Poderia ser assim: home caracter=EDsticas screenshots (talvez screenshots possa ser jogado como um subitem de caracter=EDsticas, limpando um pouco a =E1rea) downloads perguntas dicas comunidade de usu=E1rio (?) como ajudar (aqui ou no grupo de baixo?) equipe parcerias fale conosco t+ andrei > Ol=E1 pessoal!! > > Faz um tempo que n=E3o escrevo para a lista. Andava meio atarefado.. > > Enfim, estou enviando o layout da p=E1gina do Notes > > Uma observa=E7=E3o: > > No layout da p=E1gina Equipe do Notes eu s=F3 coloquei algu ns nomes porque > muitos de voc=EA ainda n=E3o colocaram suas informa=E7=F5es em > http://notes2.sourceforge.net/mkt/wakka.php? wakka=3DSessaoSobreAEquipe > > > ------------------------------------------------------- -------------- > Allan Rodrigo > #Equipe do Notes - Coordena=E7=E3o de Marketing/Design > > -- > +++ GMX - die erste Adresse f=FCr Mail, Message, More +++ > Neu: Preissenkung f=FCr MMS und FreeMMS! http://www.gmx.n et > -- RGB Design Digital - Andrei R. Thomaz www.rgbdesigndigital.com.br __________________________________________________________________________ Acabe com aquelas janelinhas que pulam na sua tela. AntiPop-up UOL - =C9 gr=E1tis! http://antipopup.uol.com.br/ |
From: andreithomaz <and...@bo...> - 2003-12-22 04:11:04
|
gente, estou vendo a vers=E3o do NotesSE que o Anderson enviou hj. coment=E1rios: a) a StartPage =E9 =F3tima, mas seria bom se 1) as tarefas comuns fossem substitu=EDdas pelos =EDcones tradicionais das mesmas; do jeito que est=E1, parece que a gente vai receber algum tipo de ajuda sobre a tarefa (eu sei que est=E1 escrito "tarefas comuns" em cima, e n=E3o "ajuda", mas o conjunto passa essa impress=E3o); 2) se desse para "ligar/desligar" a StartPage; b) imagino q as teclas de atalho venham a ser configur=E1veis na vers=E3o final. Mas, se n=E3o forem, sugiro que as teclas de identa=E7=E3o sejam CTRL+[ e CTRL+] (ou CTRL+SHIF+[). Pelo menos, =E9 assim nos editores q eu uso; c) o nome do menu "ferramentas" n=E3o t=E1 muito de acordo com as fun=E7=F5es... mas eu tb n=E3o consegui pensar em nada melhor! d) se eu crio o arquivo de configura=E7=E3o de colora=E7=E3o par auma linguagem, ela n=E3o aparece na biblioteca, n=E9? como adicionar linguagens =E0 biblioteca? Seria bom utilizar arquivos para isso, de formas que estes arquivos pudessem ser trocados pelos usu=E1rios do Notes. e) por fim: como =E9 natal, meus clientes est=E3o de f=E9rias, e eu estou podendo me dedicar =E0s coisas que n=E3o s=E3o para ontem. Por favor, se vcs puderem listar o que h=E1 para fazer na parte visual do NotesSE, eu agradeceria. um abra=E7o a todos, andrei -- RGB Design Digital - Andrei R. Thomaz www.rgbdesigndigital.com.br __________________________________________________________________________ Acabe com aquelas janelinhas que pulam na sua tela. AntiPop-up UOL - =C9 gr=E1tis! http://antipopup.uol.com.br/ |
From: andreithomaz <and...@bo...> - 2003-12-22 03:53:51
|
ol=E1 a todos, a=ED vai uma sugest=E3o quanto aos tipos de arquivo: no site do Blender (um programa de 3d open source) h=E1 a se=E7=E3o Community, com as coisas que os usu=E1rios do software desenvolveram e liberaram para download. No site do Notes, poderia haver algo parecido. Imaginem que eu desenvolva arquivos de configura=E7=E3o de colora=E7=E3o para ActionScript, VRML e X3D. Estes arquivos n=E3o devem ser incorporados =E0 vers=E3o do Notes, j=E1 q a equipe n=E3o deve perder o seu tempo com eles; quem deve faz=EA-lo s=E3o os usu=E1rio do software, no caso, eu :-) Ent=E3o, seria bom ter esta se=E7=E3o do tipo "coisas =FAteis feitas pelos usu=E1rios mas que s=E3o de responsabilidade deles". Q vcs acham? um abra=E7o a todos, andrei p.s.: amanh=E3 vou comprar placa m=E3e nova. ter=E7a espero estar com meu velho micro de volta, hehehe. andei meio ausente por causa de todo este transtorno. > Ol=E1 pessoal, > > Eu ia lan=E7ar isto apenas no final do doming=E3o, mas esto u adiantando =E0 > pedido de v=E1rias pessoas. > Por causa da pressa posso ter esquecido de algum arquiv o, deem uma > olhada. Mas acho que > t=E1 tudo completo. Coloquei inclusive uma primeira vers=E3 o da documenta=E7=E3o > dos fontes!! > > Baixem ae: http://notes2.sf.net/notes2004dev6.zip > (Vem com bin=E1rios e com os fontes, pra compilar precisa do SynEdit. O > SynEdit oficial n=E3o compila > no Delphi 7, mas o que eu enviei com a dev3.5 compila: > http://notes2.sf.net/notes2004dev3.5-src.zip ) > > Bom, tem v=E1rias modifica=E7=F5es nesta vers=E3o. Eu diria que estamos mais > pr=F3ximos do alpha :) > Ah! Antes q algu=E9m me incomode por isto: os di=E1logos de configura=E7=E3o > funcionam parcialmente > apenas, ou seja, nem tudo neles est=E1 pronto... > > ** Curiosidade: como adicionar suporte a mais um tipo d e arquivos ** > 1. V=E1 at=E9 [DirDoNotes]\config\FileTypes > 2. Fa=E7a uma c=F3pia da pasta "texto" e cole no mesmo dire t=F3rio > 3. Ela vai se chamar "C=F3pia de Texto" ou algo assim. Re nomei este > diret=F3rio para o nome da linguagem > que voc=EA est=E1 adicionando: exemplos: "ActionScript", "I ni Files", etc. > 4. Beleza. Agora, entre neste diret=F3rio que voc=EA criou. Voc=EA preciar=E1 > renomear estes doi arquivos: > > Texto.hgl > Texto.xml > > Voc=EA deve usar o mesmo nome da pasta em que eles est=E3o. Se voc=EA chamou a > Pasta de "ActionScript", > ent=E3o voc=EA deve deix=E1-los assim: > > ActionScript.hgl > ActionScript.xml > > 5. Essa foi a parte dif=EDcil. Abra o Notes (feche e abra novamente se ele > estiver aberto). V=E1 no di=E1logo de configura=E7=F5es > na aba "Tipos de Arquivo". Na lista vai estar o nome da linguagem que > voc=EA adicionou, por exemplo, "ActionScript". > Selecione ela e clique em "Editar tipo de arquivo". > 6. Neste di=E1logo tem v=E1rias configura=E7=F5es que voc=EA vai quer ajustar para > esta linguagem. Mas o mais importante =E9 que > voc=EA defina como vai funcionar a colroa=E7=E3o de c=F3digo pa ra ela. V=E1 para a > aba "Colora=E7=E3o". > 7. Voc=EA vai notar um bot=E3o "Op=E7=F5es Avan=E7adas >>", Cliqu e nele. Ele via > mostrar mais op=E7=F5es que permitir=E3o que > voc=EA configure o parser de c=F3digo. > 8. Voc=EA vai notar dois bot=F5es na nos op=E7=F5es que v=E3o apa recer: > > "Adicionar Range" - permite procurar por um intervalo de caracteres, um > range. Isto =E9 =FAtil para colorir coment=E1rios, strings, e tc. Vamos > adicionar um para colorir tudo que ficar entre /* e */ , isto =E9 um > coment=E1rio em C, Java e outras linguagens. PAra isto se lecione o > primeiro item da lista (que neste momento deve ter o no me de "texto") e > clique em "Adicionar Range". > D=EA um nome para o novo range ("coment=E1rios", p. ex. - fosse pode > renomea-lo a qualquer momento pressionando F2). > Nas op=E7=F5es, preencha o campo "De:" com "/*". Isto diz o nde o rande > inicia. Agora preencha o campo "At=E9:" com "*/", para > dizer onde o range termina. Desmarque as caixas "Fechar em delimitador" > e "Fechar no fim da linha". Marque a caixa "A tag que a bre o range faz > parte do termo", pois queremos que "/*" seja colorido t amb=E9m como um > coment=E1rio. =C9 isto... > > "Adicionar Keyword" - permite configurar as palavra- chaves da linguagem. > Por exemplo: if, function, for, etc. Eles devem ser > digitados um em cada linha. > > 9. =C9 basicamente isto. D=EA uma olhada em linguagens que j=E1 tem colora=E7=E3o, > pois voc=EA vai poder aprender alguns truques. Sinta- se livre para > experimentar... se voc=EA n=E3o gostar das modifica=E7=F5es, ap enas clique em > cancelar para que n=E3o sejam salvas... > > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > > Abra=E7o =E0 todos! > FeliZ nataaaaaaaaallllllllllllllllllllllllllllllllllll! !!! > > -- > Anderson Rodrigues Barbieri > -------------------------------------------- > #Equipe do Notes - Coordenador/Desenvolvedor > > { TAndInfo } > ICQ #149391850 / no...@ig... > Notes - http://notes.codigolivre.org.br > NotesDev - http://notes2.sf.net/dev > F=F3rum - http://notes2.sf.net/forum > > -- RGB Design Digital - Andrei R. Thomaz www.rgbdesigndigital.com.br __________________________________________________________________________ Acabe com aquelas janelinhas que pulam na sua tela. AntiPop-up UOL - =C9 gr=E1tis! http://antipopup.uol.com.br/ |
From: Anderson R. B. <no...@ig...> - 2003-12-22 02:24:04
|
Eu havia sugerido os seguintes: - Como compilar os seu programa com o Notes - Como fazer preview de suas p=E1ginas no servidor usando o Notes - Como usar as ferramentas do Notes para aumentar a sua produtividade Poder=EDamos ter mais alguns, tipo: - Usando o Notes como se fosse um editor HTML - Criando o seu primeiro programa usando o Notes. (Poder=EDamos ter 3=20 vers=F5es dele, para Pascal, C e Java) E podemos ter mais. Tu, Robson, que sabe Latex poderia explicar como=20 criar um documento Latex e compilar e tudo atrav=E9s do Notes. E assim vai, podemos ter muitos=20 tutoriais. Os que citei acima saum os que sei que sou capaz de escrever ou de passar todas as infos=20 necess=E1rias, no m=EDnimo. Quanto mais tutorias, melhor, mas depende do conhecimento de cada um... PESSOAS OPINEM PLEASE!!! Abra=E7o, Anderson Robson Cardoso dos Santos wrote: > Bom, achei =F3tima a sugest=E3o, presumo que usu=E1rios deste programa,= =20 > assim como qualquer putro software saibam as funcionalidades b=E1sicas=20 > destes menus :-) . Agora quais os tutorias que devemos colocar? al=E9m= =20 > deste de "Como otimizar o trabalho"? > > Anderson R. Barbieri wrote: > >> >> Realmente gostei da id=E9ia do Allan. Como usu=E1rio eu prefiro aquela= s >> documenta=E7=F5es estilo "how to...". Quando vou olhar uma documenta=E7= =E3o >> n=E3o quero saber o que um item do menu faz, mas, sim, saber como faze= r >> alguma coisa com aquele programa - n=E3o =E9 =E0 toa que as documenta=E7= =F5es >> do linux se basearam nos formatos dos How-tos... >> >> Quanto as apresenta=E7=F5es das novidades, eu concordo. Podemos copiar >> do conte=FAdo do site... :) >> >> E quanto aos tutoriais, acho que devemos ter tutoriais para v=E1rias >> coisas. Estou defendendo que tenhamos tutoriais desde o in=EDcio >> e ningu=E9m me escuta, sniff... snifff. >> >> Que voc=EAs acham de tudo isto???! Precisamos fechar isto pro pessoal >> da documenta=E7=E3o poder trabalhar. Falem logo!!! Vamos! >> >> Ab. >> Anderson >> >> Allan Rodrigo wrote: >> >>> Ol=E1 pessoal! >>> >>> Com rela=E7=E3o ao =EDndice da documenta=E7=E3o, ser=E1 realmente nec= ess=E1rio=20 >>> escrever sobre os menus? >>> As pessoas que usam o Notes s=E3o usu=E1rios avan=E7ados e eu acho qu= e a=20 >>> documenta=E7=E3o deveria estar voltada para esses usu=E1rios. >>> >>> Um usu=E1rio que n=E3o sabe o que o menu Arquivo e o Editar fazem =E9= =20 >>> porque nunca viram um computador na vida, pois todos os programas=20 >>> praticamente seguem esse mesmo padr=E3o. >>> >>> J=E1 as op=E7=F5es dos menus Inserir, Ferramentas, Executar, Op=E7=F5= es e=20 >>> Ajuda est=E3o bastante =F3bvias no programa. N=E3o precisa nem entend= er=20 >>> programa=E7=E3o para saber o que elas fazem. >>> >>> Na minha opini=E3o a documenta=E7=E3o n=E3o deveria descrever o progr= ama,=20 >>> mas sim suas a=E7=F5es. >>> A documenta=E7=E3o deveria ser escrita com o verbo sempre no infiniti= vo=20 >>> para demonstrar que =E9 uma a=E7=E3o que est=E1 sendo descrita, por e= xemplo: >>> >>> - Configurar Prefer=EAncias >>> - Usar Biblioteca de C=F3digos >>> - Executar Programa >>> - Mudar Fonte >>> - Atualizar do Programa >>> >>> Isso =E9 s=F3 um exemplo. O ideal seria colocar as a=E7=F5es menos ev= identes=20 >>> do programa. Ou seja, aquelas a=E7=F5es que n=E3o est=E1 diretamente=20 >>> colocada nos menus e que o usu=E1rio diga: "Puxa, o Notes faz isso =E9= ?"=20 >>> [risos] >>> >>> Eu acho que nesse modelo a documeta=E7=E3o vai ficar bem mais enxuta,= =20 >>> mas em compensa=E7=E3o s=F3 haver=E1 coisas importantes nela. >>> >>> Outras coisa que pode ser colocada na documenta=E7=E3o s=E3o as novid= ades=20 >>> do programa. O que o programa faz que n=E3o fazia antes e como faz. >>> >>> As hot keys s=E3o bastante importantes e devem ficar com certeza. >>> >>> Outra coisa que pode ser colocada na documenta=E7=E3o =E9 um tutorial= Como=20 >>> Otimizar o Trabalho. Poderia colocar todas as ferramentas que o=20 >>> usu=E1rio pode usar dentro do Notes para gastar menos tempo=20 >>> trabalhando ter um maior rendimento. Isso seria importante porque=20 >>> daria uma vis=E3o geral de todas as ferramentas para otimizar o traba= lho. >>> >>> O =EDndice poderia ser assim: >>> >>> 1. Introdu=E7=E3o/Novidades >>> >>> 2. Hot Keys >>> >>> 3. Usando o Notes >>> - Configurar Prefer=EAncias >>> - Usar Biblioteca de C=F3digos >>> - Executar Programa >>> - Mudar Fonte >>> - Atualizar do Programa >>> - etc. >>> - etc. >>> >>> 4. Tutoriais >>> >>> - Como Otimizar o Trabalho >>> >>> 5. Saiba mais sobre o Notes >>> - Sobre o Notes - Equipe >>> - Doa=E7=F5es >>> - Como se tornar parceiro >>> >>> 6. Cr=E9ditos e Licen=E7a >>> =20 >>> --------------------------------------------------------------------- >>> Allan Rodrigo >>> #Equipe do Notes - Coordena=E7=E3o de Marketing/Design >>> >>> >>> =20 >>> >> > > --=20 Anderson Rodrigues Barbieri -------------------------------------------- #Equipe do Notes - Coordenador/Desenvolvedor { TAndInfo } ICQ #149391850 / no...@ig... Notes - http://notes.codigolivre.org.br NotesDev - http://notes2.sf.net/dev F=F3rum - http://notes2.sf.net/forum |
From: Anderson R. B. <no...@ig...> - 2003-12-22 02:01:57
|
Fico porreta!!!! huahauahuahaua Quanto ao c=F3digo, acho muito dif=EDcil modificar ele sem deixar a local= iza=E7=E3o lerda... normalmente h=E1 uma rela=E7=E3o entre otimiza=E7=E3o e clareza = no c=F3digo. Em poucos lugares vale =E0 pena sacrificar a clareza para ter um bom ganh= o de velocidade, mas, considerando que os usu=E1rios v=E3o querer buscar em v=E1rios arquivos e tals, acho que este =E9 um destes lugares. Ou seja: t= =E1 muito bom assim!!! Agora fico no aguardo dos di=E1logos! Ab. Anderson Jonas Raoni Soares Silva wrote: > Depois de 2/3 fins de semana eu acabei o meu monstrinho=20 > heauheauehaueh, entre o icq, cs e delphi sempre sai alguma coisa :b > =20 > N=E3o tive tempo de documentar conforme as novas regras ainda,=20 > mas depois eu fa=E7o isso ;] > =20 > Estou mandano em anexo o fonte com um mini-demo q eu fiz pra testar,=20 > se poss=EDvel gostaria q algu=E9m fizesse uns testes pra ver se naum te= m=20 > nada bizarro aconteceno =3D] > =20 > Se poss=EDvel gostaria q algu=E9m procurrase uma forma de otimizar o=20 > c=F3digo, ficou taum bizarro q ateh mesmo eu q fiz tenho problemas ao=20 > analisar algumas partes e tenho q recorrer a uma folha de=20 > sulfite, simulando a mem=F3ria na folha hehe... Qualquer coisa =E9=20 > aceit=E1vel, desde q a velocidade naum seje prejudicada (eu fiz essa=20 > sujeirada toda soh por causa da velocidade, se eu fizesse usando=20 > diversos m=E9todos a coisa ficaria bunitinha, f=E1cil de debugar e=20 > compacta... mas como acessar m=E9todos toma um certo tempo - faz um=20 > benchmark com um arquivo grande ae hehe - eu decidi deixar a fun=E7=E3o= =20 > Search dakele jeito memo, cheio de coisas repetidas e tal) :b > =20 > Essa comecei a partir de ont=E9m a mexer no notes em dia de semana=20 > hahahaha, mas naum toh mto fan=E1tico ainda... soh mexo qdo dah vontade= =20 > e tinha um bug nessa minha classe q tava me arrancano os cabelo :b > =20 > =20 > Jonas Raoni Soares Silva > ----------------------------------- > #Equipe do Notes - Desenvolvimento > =20 --=20 Anderson Rodrigues Barbieri -------------------------------------------- #Equipe do Notes - Coordenador/Desenvolvedor { TAndInfo } ICQ #149391850 / no...@ig... Notes - http://notes.codigolivre.org.br NotesDev - http://notes2.sf.net/dev F=F3rum - http://notes2.sf.net/forum |
From: Robson C. d. S. <vml...@ya...> - 2003-12-21 17:39:49
|
Bom, achei =F3tima a sugest=E3o, presumo que usu=E1rios deste programa, = assim=20 como qualquer putro software saibam as funcionalidades b=E1sicas destes=20 menus :-) . Agora quais os tutorias que devemos colocar? al=E9m deste de= =20 "Como otimizar o trabalho"? Anderson R. Barbieri wrote: > > Realmente gostei da id=E9ia do Allan. Como usu=E1rio eu prefiro aquelas > documenta=E7=F5es estilo "how to...". Quando vou olhar uma documenta=E7= =E3o > n=E3o quero saber o que um item do menu faz, mas, sim, saber como fazer > alguma coisa com aquele programa - n=E3o =E9 =E0 toa que as documenta=E7= =F5es > do linux se basearam nos formatos dos How-tos... > > Quanto as apresenta=E7=F5es das novidades, eu concordo. Podemos copiar > do conte=FAdo do site... :) > > E quanto aos tutoriais, acho que devemos ter tutoriais para v=E1rias > coisas. Estou defendendo que tenhamos tutoriais desde o in=EDcio > e ningu=E9m me escuta, sniff... snifff. > > Que voc=EAs acham de tudo isto???! Precisamos fechar isto pro pessoal > da documenta=E7=E3o poder trabalhar. Falem logo!!! Vamos! > > Ab. > Anderson > > Allan Rodrigo wrote: > >> Ol=E1 pessoal! >> >> Com rela=E7=E3o ao =EDndice da documenta=E7=E3o, ser=E1 realmente nece= ss=E1rio=20 >> escrever sobre os menus? >> As pessoas que usam o Notes s=E3o usu=E1rios avan=E7ados e eu acho que= a=20 >> documenta=E7=E3o deveria estar voltada para esses usu=E1rios. >> >> Um usu=E1rio que n=E3o sabe o que o menu Arquivo e o Editar fazem =E9=20 >> porque nunca viram um computador na vida, pois todos os programas=20 >> praticamente seguem esse mesmo padr=E3o. >> >> J=E1 as op=E7=F5es dos menus Inserir, Ferramentas, Executar, Op=E7=F5e= s e Ajuda=20 >> est=E3o bastante =F3bvias no programa. N=E3o precisa nem entender=20 >> programa=E7=E3o para saber o que elas fazem. >> >> Na minha opini=E3o a documenta=E7=E3o n=E3o deveria descrever o progra= ma, mas=20 >> sim suas a=E7=F5es. >> A documenta=E7=E3o deveria ser escrita com o verbo sempre no infinitiv= o=20 >> para demonstrar que =E9 uma a=E7=E3o que est=E1 sendo descrita, por ex= emplo: >> >> - Configurar Prefer=EAncias >> - Usar Biblioteca de C=F3digos >> - Executar Programa >> - Mudar Fonte >> - Atualizar do Programa >> >> Isso =E9 s=F3 um exemplo. O ideal seria colocar as a=E7=F5es menos evi= dentes=20 >> do programa. Ou seja, aquelas a=E7=F5es que n=E3o est=E1 diretamente c= olocada=20 >> nos menus e que o usu=E1rio diga: "Puxa, o Notes faz isso =E9?" [risos= ] >> >> Eu acho que nesse modelo a documeta=E7=E3o vai ficar bem mais enxuta, = mas=20 >> em compensa=E7=E3o s=F3 haver=E1 coisas importantes nela. >> >> Outras coisa que pode ser colocada na documenta=E7=E3o s=E3o as novida= des=20 >> do programa. O que o programa faz que n=E3o fazia antes e como faz. >> >> As hot keys s=E3o bastante importantes e devem ficar com certeza. >> >> Outra coisa que pode ser colocada na documenta=E7=E3o =E9 um tutorial = Como=20 >> Otimizar o Trabalho. Poderia colocar todas as ferramentas que o=20 >> usu=E1rio pode usar dentro do Notes para gastar menos tempo trabalhand= o=20 >> ter um maior rendimento. Isso seria importante porque daria uma vis=E3= o=20 >> geral de todas as ferramentas para otimizar o trabalho. >> >> O =EDndice poderia ser assim: >> >> 1. Introdu=E7=E3o/Novidades >> >> 2. Hot Keys >> >> 3. Usando o Notes >> - Configurar Prefer=EAncias >> - Usar Biblioteca de C=F3digos >> - Executar Programa >> - Mudar Fonte >> - Atualizar do Programa >> - etc. >> - etc. >> >> 4. Tutoriais >> >> - Como Otimizar o Trabalho >> >> 5. Saiba mais sobre o Notes >> - Sobre o Notes - Equipe >> - Doa=E7=F5es >> - Como se tornar parceiro >> >> 6. Cr=E9ditos e Licen=E7a >> =20 >> --------------------------------------------------------------------- >> Allan Rodrigo >> #Equipe do Notes - Coordena=E7=E3o de Marketing/Design >> >> >> =20 >> > --=20 Robson Cardoso dos Santos #Equipe do Notes - Coordenador/Documenta=E7=E3o |
From: Anderson R. B. <no...@ig...> - 2003-12-21 17:23:01
|
Realmente gostei da id=E9ia do Allan. Como usu=E1rio eu prefiro aquelas documenta=E7=F5es estilo "how to...". Quando vou olhar uma documenta=E7=E3= o n=E3o quero saber o que um item do menu faz, mas, sim, saber como fazer alguma coisa com aquele programa - n=E3o =E9 =E0 toa que as documenta=E7=F5= es do linux se basearam nos formatos dos How-tos... Quanto as apresenta=E7=F5es das novidades, eu concordo. Podemos copiar do conte=FAdo do site... :) E quanto aos tutoriais, acho que devemos ter tutoriais para v=E1rias coisas. Estou defendendo que tenhamos tutoriais desde o in=EDcio e ningu=E9m me escuta, sniff... snifff. Que voc=EAs acham de tudo isto???! Precisamos fechar isto pro pessoal da documenta=E7=E3o poder trabalhar. Falem logo!!! Vamos! Ab. Anderson Allan Rodrigo wrote: >Ol=E1 pessoal! > >Com rela=E7=E3o ao =EDndice da documenta=E7=E3o, ser=E1 realmente necess= =E1rio escrever sobre os menus? >As pessoas que usam o Notes s=E3o usu=E1rios avan=E7ados e eu acho que a= documenta=E7=E3o deveria estar voltada para esses usu=E1rios. > >Um usu=E1rio que n=E3o sabe o que o menu Arquivo e o Editar fazem =E9 po= rque nunca viram um computador na vida, pois todos os programas praticame= nte seguem esse mesmo padr=E3o. > >J=E1 as op=E7=F5es dos menus Inserir, Ferramentas, Executar, Op=E7=F5es = e Ajuda est=E3o bastante =F3bvias no programa. N=E3o precisa nem entender= programa=E7=E3o para saber o que elas fazem. > >Na minha opini=E3o a documenta=E7=E3o n=E3o deveria descrever o programa= , mas sim suas a=E7=F5es. >A documenta=E7=E3o deveria ser escrita com o verbo sempre no infinitivo = para demonstrar que =E9 uma a=E7=E3o que est=E1 sendo descrita, por exemp= lo: > >- Configurar Prefer=EAncias >- Usar Biblioteca de C=F3digos >- Executar Programa >- Mudar Fonte >- Atualizar do Programa > >Isso =E9 s=F3 um exemplo. O ideal seria colocar as a=E7=F5es menos evide= ntes do programa. Ou seja, aquelas a=E7=F5es que n=E3o est=E1 diretamente= colocada nos menus e que o usu=E1rio diga: "Puxa, o Notes faz isso =E9?"= [risos] > >Eu acho que nesse modelo a documeta=E7=E3o vai ficar bem mais enxuta, ma= s em compensa=E7=E3o s=F3 haver=E1 coisas importantes nela. > >Outras coisa que pode ser colocada na documenta=E7=E3o s=E3o as novidade= s do programa. O que o programa faz que n=E3o fazia antes e como faz. > >As hot keys s=E3o bastante importantes e devem ficar com certeza. > >Outra coisa que pode ser colocada na documenta=E7=E3o =E9 um tutorial Co= mo Otimizar o Trabalho. Poderia colocar todas as ferramentas que o usu=E1= rio pode usar dentro do Notes para gastar menos tempo trabalhando ter um = maior rendimento.=20 >Isso seria importante porque daria uma vis=E3o geral de todas as ferrame= ntas para otimizar o trabalho. > >O =EDndice poderia ser assim: > >1. Introdu=E7=E3o/Novidades > >2. Hot Keys > >3. Usando o Notes >- Configurar Prefer=EAncias >- Usar Biblioteca de C=F3digos >- Executar Programa >- Mudar Fonte >- Atualizar do Programa >- etc. >- etc. > >4. Tutoriais > >- Como Otimizar o Trabalho > >5. Saiba mais sobre o Notes >- Sobre o Notes=20 >- Equipe >- Doa=E7=F5es >- Como se tornar parceiro > >6. Cr=E9ditos e Licen=E7a > =20 >--------------------------------------------------------------------- >Allan Rodrigo >#Equipe do Notes - Coordena=E7=E3o de Marketing/Design > > > =20 > --=20 Anderson Rodrigues Barbieri -------------------------------------------- #Equipe do Notes - Coordenador/Desenvolvedor { TAndInfo } ICQ #149391850 / no...@ig... Notes - http://notes.codigolivre.org.br NotesDev - http://notes2.sf.net/dev F=F3rum - http://notes2.sf.net/forum |
From: Allan R. <all...@gm...> - 2003-12-21 16:33:30
|
Ol=E1 pessoal! Com rela=E7=E3o ao =EDndice da documenta=E7=E3o, ser=E1 realmente necess=E1rio= escrever sobre os menus? As pessoas que usam o Notes s=E3o usu=E1rios avan=E7ados e eu acho que= a documenta=E7=E3o deveria estar voltada para esses usu=E1rios. Um usu=E1rio que n=E3o sabe o que o menu Arquivo e o Editar fazem =E9= porque nunca viram um computador na vida, pois todos os= programas praticamente seguem esse mesmo padr=E3o. J=E1 as op=E7=F5es dos menus Inserir, Ferramentas, Executar, Op=E7=F5es e= Ajuda est=E3o bastante =F3bvias no programa. N=E3o precisa nem= entender programa=E7=E3o para saber o que elas fazem. Na minha opini=E3o a documenta=E7=E3o n=E3o deveria descrever o programa,= mas sim suas a=E7=F5es. A documenta=E7=E3o deveria ser escrita com o verbo sempre no= infinitivo para demonstrar que =E9 uma a=E7=E3o que est=E1 sendo= descrita, por exemplo: - Configurar Prefer=EAncias - Usar Biblioteca de C=F3digos - Executar Programa - Mudar Fonte - Atualizar do Programa Isso =E9 s=F3 um exemplo. O ideal seria colocar as a=E7=F5es menos= evidentes do programa. Ou seja, aquelas a=E7=F5es que n=E3o est=E1= diretamente colocada nos menus e que o usu=E1rio diga: "Puxa, o= Notes faz isso =E9?" [risos] Eu acho que nesse modelo a documeta=E7=E3o vai ficar bem mais enxuta,= mas em compensa=E7=E3o s=F3 haver=E1 coisas importantes nela. Outras coisa que pode ser colocada na documenta=E7=E3o s=E3o as= novidades do programa. O que o programa faz que n=E3o fazia antes= e como faz. As hot keys s=E3o bastante importantes e devem ficar com certeza. Outra coisa que pode ser colocada na documenta=E7=E3o =E9 um tutorial= Como Otimizar o Trabalho. Poderia colocar todas as ferramentas= que o usu=E1rio pode usar dentro do Notes para gastar menos tempo= trabalhando ter um maior rendimento. Isso seria importante porque daria uma vis=E3o geral de todas as= ferramentas para otimizar o trabalho. O =EDndice poderia ser assim: 1. Introdu=E7=E3o/Novidades 2. Hot Keys 3. Usando o Notes - Configurar Prefer=EAncias - Usar Biblioteca de C=F3digos - Executar Programa - Mudar Fonte - Atualizar do Programa - etc. - etc. 4. Tutoriais - Como Otimizar o Trabalho 5. Saiba mais sobre o Notes - Sobre o Notes - Equipe - Doa=E7=F5es - Como se tornar parceiro 6. Cr=E9ditos e Licen=E7a -----------------------------------------------------------------= ---- Allan Rodrigo #Equipe do Notes - Coordena=E7=E3o de Marketing/Design ------------------------------------------------------------ Remetente: Robson Cardoso dos Santos - vml...@ya... Data: 2003-12-20. Hora: 12:12:59 ------------------------------------------------------------ Texto Original: Pessoal, vou PEDIR mais uma vez, leiam o "=EDndice" da= documenta=E7=E3o que est=E1 no wiki= http://notes2.sourceforge.net/doc/wakka.php?wakka=3DHomePage, e digam o que acham da proposta, pois n=E3o sou adivinha para saber= tudo o que deve ser colocado l=E1, =E9 claro que tem algumas coisas l=E1 que= n=E3o se aplicam em nosso caso, pois ele foi baseado em um =EDndice de um aplicativo do linux que achei bom, ent=E3o preciso que me digam o= que deve ser incluido ou tirado dele, para isso usem a pr=F3pria p=E1gina da documenta=E7=E3o, ou sen=E3o mandem para a lista num formato de f=E1cil compreens=E3o, acedito que esta tarefa fica mais f=E1cil para os desenvolvedores, pois s=E3o muito mais =EDntimos do programa. Estou esperando a colabora=E7=E3o de todos, caso contr=E1rio este= "=EDndice" NUNCA vai ficar pronto. -- Robson Cardoso dos Santos #Equipe do Notes - Coordenador/Documenta=E7=E3o ------------------------------------------------------- This SF.net email is sponsored by: IBM Linux Tutorials. Become an expert in LINUX or just sharpen your skills. Sign up= for IBM's Free Linux Tutorials. Learn everything from the bash shell to= sys admin. Click now! http://ads.osdn.com/?ad_id=1278&alloc_id371&op=3Dclick _______________________________________________ notes2-team mailing list not...@li... https://lists.sourceforge.net/lists/listinfo/notes2-team ------------------------------------------------------------ |
From: Robson C. d. S. <vml...@ya...> - 2003-12-21 01:53:33
|
Pessoal, vou PEDIR mais uma vez, leiam o "=EDndice" da documenta=E7=E3o= que=20 est=E1 no wiki http://notes2.sourceforge.net/doc/wakka.php?wakka=3DHomePa= ge,=20 e digam o que acham da proposta, pois n=E3o sou adivinha para saber tudo = o=20 que deve ser colocado l=E1, =E9 claro que tem algumas coisas l=E1 que n=E3= o se=20 aplicam em nosso caso, pois ele foi baseado em um =EDndice de um=20 aplicativo do linux que achei bom, ent=E3o preciso que me digam o que dev= e=20 ser incluido ou tirado dele, para isso usem a pr=F3pria p=E1gina da=20 documenta=E7=E3o, ou sen=E3o mandem para a lista num formato de f=E1cil=20 compreens=E3o, acedito que esta tarefa fica mais f=E1cil para os=20 desenvolvedores, pois s=E3o muito mais =EDntimos do programa. Estou esperando a colabora=E7=E3o de todos, caso contr=E1rio este "=EDndi= ce"=20 NUNCA vai ficar pronto. --=20 Robson Cardoso dos Santos #Equipe do Notes - Coordenador/Documenta=E7=E3o |
From: Robson C. d. S. <vml...@ya...> - 2003-12-20 22:30:49
|
Parab=E9ns! Este layout ficou show de bola! Allan Rodrigo wrote: >Ol=E1 pessoal!! > >Faz um tempo que n=E3o escrevo para a lista. Andava meio atarefado.. > >Enfim, estou enviando o layout da p=E1gina do Notes > >Uma observa=E7=E3o: > >No layout da p=E1gina Equipe do Notes eu s=F3 coloquei alguns nomes porq= ue >muitos de voc=EA ainda n=E3o colocaram suas informa=E7=F5es em >http://notes2.sourceforge.net/mkt/wakka.php?wakka=3DSessaoSobreAEquipe > > >--------------------------------------------------------------------- >Allan Rodrigo >#Equipe do Notes - Coordena=E7=E3o de Marketing/Design > > =20 > -------------------------------------------=20 Robson Cardoso dos Santos #Equipe do Notes - Coordenador/Documenta=E7=E3o |
From: Anderson R. B. <no...@ig...> - 2003-12-20 17:25:04
|
Ol=E1 pessoal, Eu ia lan=E7ar isto apenas no final do doming=E3o, mas estou adiantando =E0= =20 pedido de v=E1rias pessoas. Por causa da pressa posso ter esquecido de algum arquivo, deem uma=20 olhada. Mas acho que t=E1 tudo completo. Coloquei inclusive uma primeira vers=E3o da documenta= =E7=E3o=20 dos fontes!! Baixem ae: http://notes2.sf.net/notes2004dev6.zip (Vem com bin=E1rios e com os fontes, pra compilar precisa do SynEdit. O=20 SynEdit oficial n=E3o compila no Delphi 7, mas o que eu enviei com a dev3.5 compila:=20 http://notes2.sf.net/notes2004dev3.5-src.zip ) Bom, tem v=E1rias modifica=E7=F5es nesta vers=E3o. Eu diria que estamos m= ais=20 pr=F3ximos do alpha :) Ah! Antes q algu=E9m me incomode por isto: os di=E1logos de configura=E7=E3= o=20 funcionam parcialmente apenas, ou seja, nem tudo neles est=E1 pronto... ** Curiosidade: como adicionar suporte a mais um tipo de arquivos ** 1. V=E1 at=E9 [DirDoNotes]\config\FileTypes 2. Fa=E7a uma c=F3pia da pasta "texto" e cole no mesmo diret=F3rio 3. Ela vai se chamar "C=F3pia de Texto" ou algo assim. Renomei este=20 diret=F3rio para o nome da linguagem que voc=EA est=E1 adicionando: exemplos: "ActionScript", "Ini Files", etc= . 4. Beleza. Agora, entre neste diret=F3rio que voc=EA criou. Voc=EA precia= r=E1=20 renomear estes doi arquivos: Texto.hgl Texto.xml Voc=EA deve usar o mesmo nome da pasta em que eles est=E3o. Se voc=EA cha= mou a=20 Pasta de "ActionScript", ent=E3o voc=EA deve deix=E1-los assim: ActionScript.hgl ActionScript.xml 5. Essa foi a parte dif=EDcil. Abra o Notes (feche e abra novamente se el= e=20 estiver aberto). V=E1 no di=E1logo de configura=E7=F5es na aba "Tipos de Arquivo". Na lista vai estar o nome da linguagem que=20 voc=EA adicionou, por exemplo, "ActionScript". Selecione ela e clique em "Editar tipo de arquivo". 6. Neste di=E1logo tem v=E1rias configura=E7=F5es que voc=EA vai quer aju= star para=20 esta linguagem. Mas o mais importante =E9 que voc=EA defina como vai funcionar a colroa=E7=E3o de c=F3digo para ela. V=E1= para a=20 aba "Colora=E7=E3o". 7. Voc=EA vai notar um bot=E3o "Op=E7=F5es Avan=E7adas >>", Clique nele. = Ele via=20 mostrar mais op=E7=F5es que permitir=E3o que voc=EA configure o parser de c=F3digo. 8. Voc=EA vai notar dois bot=F5es na nos op=E7=F5es que v=E3o aparecer: "Adicionar Range" - permite procurar por um intervalo de caracteres, um=20 range. Isto =E9 =FAtil para colorir coment=E1rios, strings, etc. Vamos=20 adicionar um para colorir tudo que ficar entre /* e */, isto =E9 um=20 coment=E1rio em C, Java e outras linguagens. PAra isto selecione o=20 primeiro item da lista (que neste momento deve ter o nome de "texto") e=20 clique em "Adicionar Range". D=EA um nome para o novo range ("coment=E1rios", p. ex. - fosse pode=20 renomea-lo a qualquer momento pressionando F2). Nas op=E7=F5es, preencha o campo "De:" com "/*". Isto diz onde o rande=20 inicia. Agora preencha o campo "At=E9:" com "*/", para dizer onde o range termina. Desmarque as caixas "Fechar em delimitador"=20 e "Fechar no fim da linha". Marque a caixa "A tag que abre o range faz=20 parte do termo", pois queremos que "/*" seja colorido tamb=E9m como um=20 coment=E1rio. =C9 isto... "Adicionar Keyword" - permite configurar as palavra-chaves da linguagem.=20 Por exemplo: if, function, for, etc. Eles devem ser digitados um em cada linha. 9. =C9 basicamente isto. D=EA uma olhada em linguagens que j=E1 tem color= a=E7=E3o,=20 pois voc=EA vai poder aprender alguns truques. Sinta-se livre para=20 experimentar... se voc=EA n=E3o gostar das modifica=E7=F5es, apenas cliqu= e em=20 cancelar para que n=E3o sejam salvas... =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Abra=E7o =E0 todos! FeliZ nataaaaaaaaallllllllllllllllllllllllllllllllllll!!!! --=20 Anderson Rodrigues Barbieri -------------------------------------------- #Equipe do Notes - Coordenador/Desenvolvedor { TAndInfo } ICQ #149391850 / no...@ig... Notes - http://notes.codigolivre.org.br NotesDev - http://notes2.sf.net/dev F=F3rum - http://notes2.sf.net/forum |
From: Allan R. <all...@gm...> - 2003-12-20 14:02:43
|
Relatório do Marketing/Design (Para conhecimento de todos os noteiros) MAIS DE 10.000 DOWNLOADS EM APENAS 1 ANO!!! ############################################# 1º Assunto: Aniversário do Notes Dia 15/12 o Notes completou um aninho. Que lindio :) E já tem mais de 10.000 downloads. Muito mais que muitos programas... As metas do Notes 2 são mais rigorosas, mas verificamos com esse marco que acabamos de atingir que é possível atingir nossas metas. Espero que todos se motivem para que as próximas versões do Notes façam tanto sucesso quanto as versões anteriores! 2º Assunto: Estatísticas do Notes (novembro) Mês de outubro Superdownloads : 278 Pegar.com.br: 142 Baixaki.ig.com.br: 167 Site do Notes: 257 Progs.com.br: 3 Desconhecido: 1 SourceForge: 220 Progs.com.br: 0 ____________________ Total: 1.067 downloads em outubro Total de pageviews: 1. 500 (aproximado) Depois de 3 aumentos consecutivos tivemos a nossa primeira redução. Porém, devemos levar em consideração que o mês de outubro foi espetacular (tivemos 1.295 downloads) e mesmo com a queda de novembro tivemos o segundo maior número de downloads desde que eles começaram a ser contados mensalmente! Total de Downloads: 10.186 (acumulado) Page Views: 17.834 (acumulado) ---------------------------------------------------------------------- 3º Assunto: Layout Bom, enfim, hoje entreguei o fim final dos layouts :-) Agora sim o novo site anda. Agora é a vez de Leandro e Alexandre Gravem se divertirem. Ficamos agradecidos pela sua ajuda, Alexandre. ---------------------------------------------------------------------- 4º Assunto: Afastamento de Allan Do próximo sábado, dia 27, até dia 01 de fevereiro estarei temporariamente afastado do Notes. Vou fazer uma longa viagem e resolver algumas pendências... ############################################## Pendências 1- Escrever uma carta para papai Noel (Allan) 2- Arrumar a árvore de Natal (Andrei) ############################################## Cometários: Que o Natal seja mais um momento em que as pessoas acreditem que vale a pena viver um Ano Novo. Feliz Natal!!! --------------------------------------------------------------------- Allan Rodrigo #Equipe do Notes - Coordenação de Marketing/Design -- +++ GMX - die erste Adresse für Mail, Message, More +++ Neu: Preissenkung für MMS und FreeMMS! http://www.gmx.net |
From: Allan R. <all...@gm...> - 2003-12-20 14:00:29
|
Olá pessoal!! Faz um tempo que não escrevo para a lista. Andava meio atarefado.. Enfim, estou enviando o layout da página do Notes Uma observação: No layout da página Equipe do Notes eu só coloquei alguns nomes porque muitos de você ainda não colocaram suas informações em http://notes2.sourceforge.net/mkt/wakka.php?wakka=SessaoSobreAEquipe --------------------------------------------------------------------- Allan Rodrigo #Equipe do Notes - Coordenação de Marketing/Design -- +++ GMX - die erste Adresse für Mail, Message, More +++ Neu: Preissenkung für MMS und FreeMMS! http://www.gmx.net |
From: Jonas R. S. S. <jon...@bo...> - 2003-12-19 18:38:50
|
Ai ai, comi demais aki no servi=E7o hehe (teve uma boca libre aki, aind= a bem q eu naum engordo ainda :b), toh ateh me sentido pesadaum... Mas = tava mto baum :0 Deixa eu fazer um mini-relat=F3rio :b :: Classe TN= otesSeeker -> 100% Implementada (parece q naum tem bugs, mas vai saber= hehe) :: Di=E1logos de procura/substitui=E7=E3o para o notes usando= a classe TNotesSeeker -> Eu naum gosto mto de fazer interfaces, ou seja= , se ficar meio zuado, naum reclamem, eu jah pedi para naum fazer iss= o hehe :P :: Suporte a projetos -> Ap=F3s e/ou em conjunto com os di=E1= logos eu vou tocar a parte de projetos que ser=E1 mais simples q o neg=F3= cio de busca, mas naum menos trabalhoso... mto pelo contr=E1rio hehe,= vai dah um trabalho danado pq tem mta frescurite :] Espero que todo= mundo deixe um relat=F3rim, eu toh meio curioso pra saber o q o resto = do povo tah fazeno :] Veliz Nadal, ALAH vai mandar dodo mundu arder no= m=E1rmuri do inv=EArnu huhu :b []'s Jonas Raoni Soares Silva --= -------------------------------- #Equipe do Notes - Desenvolvimento=0A =0A= _________________________________________________________________________= _=0AAcabe com aquelas janelinhas que pulam na sua tela.=0AAntiPop-up UOL = - =C9 gr=E1tis!=0Ahttp://antipopup.uol.com.br/=0A |
From: Anderson R. B. <no...@ig...> - 2003-12-17 04:03:47
|
Achei uma ferramenta de documenta=E7=E3o derivada do PasDoc que aceita HTML nos coment=E1rios - o que eu estava sentindo muita falta, hehehhehe Outra vantagem =E9 que ele tem uma gui, inclusive em portugu=EAs... ainda to testando pra ver como eh... http://www.zeitungsjunge.de/delphi/pasdoc/index.htm --=20 Anderson Rodrigues Barbieri -------------------------------------------- #Equipe do Notes - Coordenador/Desenvolvedor { TAndInfo } ICQ #149391850 / no...@ig... Notes - http://notes.codigolivre.org.br NotesDev - http://notes2.sf.net/dev F=F3rum - http://notes2.sf.net/forum |
From: Anderson R. B. <no...@ig...> - 2003-12-16 03:47:14
|
Ol=E1 noteiros, temos um novo candidato a membro. Trata-se do Alexandre Gravem. De in=EDcio ele vai nos ajudar no site (Leandro, seria uma boa voc=EAs entrarem em contato, o mail dele =E9 kar...@ig...). Alexandre, a tua tarefa ser=E1, em conjunto com o Leandro=20 (ps...@te...) criar o novo site do Notes. O Layout est=E1 quase pronto (o Allan acaba d= e=20 me dizer que at=E9 sexta entrega o layout definitivo) e os textos est=E3o sendo=20 escritos no wiki do marketing e ficam em=20 http://notes2.sourceforge.net/mkt/wakka.php?wakka=3DTextodoSite L=E1 tem as sess=F5es que o site vai ter tb=E9m... A id=E9ia =E9 que o site seja facilmente atualiz=E1vel pela web. A minha = id=E9ia=20 =E9 que usemos php e mysql pra isto, acho que o Leandro pensa o mesmo. Tu e o Lendro=20 tem carta branca para decidirem como v=E3o se organizar e como v=E3o organizar o si= te.=20 Sempre que pensarem em fazer algo meio louco ou tiverem d=FAvidas, mandem e-mail pra= =20 lista... Alexandre, a gente se comunica muito por ICQ. Se tu usar ICQ o meu =E9 o=20 149391850 . Se n=E3o usar, tudo bem, hehehehe... Todo mundo que entra na equipe tem=20 sempre muitas d=FAvidas. N=E3o deixe de perguntar - cada pessoa tem d=FAvidas diferente= s,=20 acima eu tentei dar as informa=E7=F5es que eu acho que tu precisa, mas posso ter esquecid= o=20 de algo importante. Qualquer coisa =E9 s=F3 falar :) --=20 Anderson Rodrigues Barbieri -------------------------------------------- #Equipe do Notes - Coordenador/Desenvolvedor { TAndInfo } ICQ #149391850 / no...@ig... Notes - http://notes.codigolivre.org.br NotesDev - http://notes2.sf.net/dev F=F3rum - http://notes2.sf.net/forum |
From: Anderson R. B. <no...@ig...> - 2003-12-16 03:26:24
|
Pessoal, eu cometi dois errinhos no texto que enviei sobre como documentar o c=F3digo ontem... e descobri uma coisinha: 1. O coment=E1rio sempre tem que vir antes do treco que se quer documenta= r. ent=E3o onde eu disse pra comentar ao lado das vari=E1veis tava errado, t= em que ser em cima delas. 2. Onde eu disse pra usar coment=E1rio do tipo (** *), troquem por (* *). 3. Apesar da documenta=E7=E3o do PasDoc dizer que ele aceita a instru=E7=E3= o @param texto, texto... ela naum funciona direito. =C9 preciso colocar o texto entre par=EAnteses. Ex: @param(S string que recebe sei l=E1 o q) J=E1 atualizei o NotesDev. No linque abaixo t=E1 o texto iteiro com as co= rre=E7=F5es e mais infos... http://notes2.sourceforge.net/dev/wakka.php?wakka=3DDocumenteOCodigo Outra: entre ontem e hoje j=E1 comentei boa parte dos fontes do Notes.=20 Acho que falta apenas a parte dif=EDcil - documentar a unit frm_princ.pas, heheheh= eh. Se todo mundo documentar o c=F3digo vamos ter a documenta=E7=E3o completa logo, logo. O que pra n=F3s vai ser =F3timo :) --=20 Anderson Rodrigues Barbieri -------------------------------------------- #Equipe do Notes - Coordenador/Desenvolvedor { TAndInfo } ICQ #149391850 / no...@ig... Notes - http://notes.codigolivre.org.br NotesDev - http://notes2.sf.net/dev F=F3rum - http://notes2.sf.net/forum |
From: Anderson R. B. <no...@ig...> - 2003-12-15 16:58:00
|
Joao, Eu dei uma olhada nas tuas opcoes de configuracao da lista e vi que tu=20 marcou a opcao para receber as mensagens em plain text. E por isto que tu esta=20 tendo problemas: o mailman tenta converter as mensagens html para plaintext e obviamente=20 isto naum da em boa coisa. Tente mudar as configuracoes pra receber as msgs em HTML... Quanto a organizacao da documentacao do Notes, que areas sao estas "PHP,=20 ASP, e Java Script". Nao combinamos nada conectado a estas linguagens. A documentacao eh=20 sobre o Notes, nao sobre linguagens... nao to entendendo nada. Alguem pode me explicar isto=20 direito??? Ab. Anderson Joao Vagner Brito de Medeiros wrote: > Cada Um que for fazendo a documenta=E7=E3o, escolher=E1 uma dupla, como= foi=20 > Decidido entre eu e robson (eu dei a ideia) ele aceitou. > > Estamos cuidando das Areas de PHP, ASP, e Java Script. > > Uma pequena Observa=E7=E3o: Troquem o sistema aqui de Listam pois minha= =20 > caixa de email l=E9 tipo assim: > Usaremos um utilit=3DE1rio chamado _pasdoc_ pra gerar uma=20 > documenta=3DE7=3DE3o,=3D > pois=3D20 > ele cata > os coment=3DE1rios do c=3DF3digo e cria os HTMLs (exemplo feito com os=20 > fontes=3D > do=3D20 > > Ai esta commplicando muito para mim ler. > > Obrigado > > >> From: not...@li... >> Reply-To: not...@li... >> To: not...@li... >> Subject: notes2-team digest, Vol 1 #247 - 2 msgs >> Date: Sun, 14 Dec 2003 20:09:13 -0800 >> >> Send notes2-team mailing list submissions to >> not...@li... >> >> To subscribe or unsubscribe via the World Wide Web, visit >> https://lists.sourceforge.net/lists/listinfo/notes2-team >> or, via email, send a message with subject or body 'help' to >> not...@li... >> >> You can reach the person managing the list at >> not...@li... >> >> When replying, please edit your Subject line so it is more specific >> than "Re: Contents of notes2-team digest..." >> >> >> Today's Topics: >> >> 1. ** =3D?ISO-8859-1?Q?Documenta=3DE7=3DE3o_dos_fontes_do_Notes_?=3D >> =3D?ISO-8859-1?Q?**?=3D (Anderson R. Barbieri) >> >> --__--__-- >> >> Message: 1 >> Date: Mon, 15 Dec 2003 01:50:25 -0200 >> From: "Anderson R. Barbieri" <no...@ig...> >> To: not...@li... >> Subject: [Notes2-team] **=20 >> =3D?ISO-8859-1?Q?Documenta=3DE7=3DE3o_dos_fontes_do_Notes_?=3D >> =3D?ISO-8859-1?Q?**?=3D >> Reply-To: not...@li... >> >> This is a multi-part message in MIME format. >> --------------030708010507050300030206 >> Content-Type: text/plain; charset=3DISO-8859-1; format=3Dflowed >> Content-Transfer-Encoding: quoted-printable >> >> >> Ol=3DE1 noteiros de todas as est=3DE2ncias! >> >> Eis um in=3DEDcio de esfor=3DE7o para termos uma documenta=3DE7=3DE3o = dos=20 >> fontes =3D >> do Notes!!! >> http://notes2.sourceforge.net/dev/wakka.php?wakka=3D3DNotesSE2004 >> >> A partir de agora *POR FAVOR, TODOS* documentem todo o c=3DF3digo que=20 >> fizer=3D >> em. >> Usaremos um utilit=3DE1rio chamado _pasdoc_ pra gerar uma=20 >> documenta=3DE7=3DE3o,=3D >> pois=3D20 >> ele cata >> os coment=3DE1rios do c=3DF3digo e cria os HTMLs (exemplo feito com os= =20 >> fontes=3D >> do=3D20 >> notes atuais >> http://notes2.sf.net/srcdocs.zip). >> >> Eu compilei o pasdoc pra windows usando os fontes do CVS. Eu=20 >> recomendo q=3D20 >> usem est=3DE1 >> vers=3DE3o q compilei (a q t=3DE1 no site deles n=3DE3o funciona, s=3D= F3 d=3DE1=20 >> mer=3D >> da). >> http://notes2.sf.net/pasdoc.zip >> O site do pasdoc =3DE9 http://pasdoc.sourceforge.net >> >> >> http://notes2.sourceforge.net/dev/wakka.php?wakka=3D3DDocumenteOCodigo >> =3D3D=3D3D=3D3D=3D3D=3D3D >> >> >> Documente o C=3DF3digo >> >> *Introdu=3DE7=3DE3o* >> Para facilitar a entrada de novos desenvolvedores na equipe e as=3D20 >> contribui=3DE7=3DF5es de nossos usu=3DE1rios >> o c=3DF3digo fonte do Notes precisa estar documentado. Para isto=20 >> usaremos o=3D >> =3D20 >> PasDoc, um utilit=3DE1rio >> capaz de usar os coment=3DE1rios do c=3DF3digo fonte para criar a=20 >> documenta=3DE7=3D >> =3DE3o.=3D20 >> Abaixo voc=3DEA aprende >> a documentar o c=3DF3digo. >> >> *In=3DEDcio de Unit* >> (** >> @abstract(NomeDaUnit - descri=3DE7=3DE3o.) >> @author(PrimeiroAutor ) >> @author(SegundoAutor ) >> Descri=3DE7=3DE3o mais detalhada do que a unit faz, pra que serve,etc. >> *) >> unit NomeDaUnit; >> >> *Antes de DECLARA=3DC7=3DD5ES de m=3DE9todos, types, constantes, recor= ds,=20 >> etc.* >> {descri=3DE7=3DE3o do que que o c=3DF3digo faz usando um coment=3DE1ri= o simples} >> declara=3DE7=3DE3o do type, constante, etc.; >> >> *Vari=3DE1veis* >> nomeDaVari=3DE1vel: type; // pra que serve a vari=3DE1vel, usando=20 >> coment=3DE1ri=3D >> o simples >> >> *procedures e fun=3DE7=3DF5es* >> No caso de procedures/fun=3DE7=3DF5es nque n=3DE3o sejam =3DF3bvias de= =20 >> entender -=3D >> a=3D20 >> maioria - voc=3DEA >> deve documentar pra q servem cada um dos par=3DE2metros e o que a=20 >> fun=3DE7=3DE3=3D >> o retorna >> (** >> @param par=3DE2metro1 descri=3DE7=3DE3o do que deve ser passado. >> @param par=3DE2metro1 descri=3DE7=3DE3o do que deve ser passado. >> @result descri=3DE7=3DE3o do que =3DE9 retornado, no caso de fun=3DE7=3D= F5es. >> *) >> function tantam(par=3DE2metro1, par=3DE2metro2...): algo; >> >> *Conclus=3DE3o* >> =3DE9 preciso ressaltar que apenas os coment=3DE1rios das declara=3DE7= =3DF5es=20 >> con=3D >> tam, o=3D20 >> resto n=3DE3o >> aparece na documenta=3DE7=3DE3o. =3DC9 importante que voc=3DEA v=3DE1=20 >> comentando en=3D >> quanto cria o >> c=3DF3digo, pois depois =3DE9 um saco ter que abrir a unit e ir=20 >> comentando=3D20 >> procedure por procedure! >> Fa=3DE7a coment=3DE1rios objetivos. Lembre-se que um dia pode ser que=20 >> voc=3DEA =3D >> mesmo=3D20 >> acabe tendo >> que ler a documenta=3DE7=3DE3o e com certeza voc=3DEA n=3DE3o vai quer= er ler=20 >> algo=3D >> mal=3D20 >> escrito :) >> >> >> **=3D3D=3D3D=3D3D=3D3D=3D3D >> >> A minha id=3DE9ia =3DE9 distribuir duas vers=3DF5es do Notes SE 2004. = Uma=20 >> ser=3DE1=3D >> o=3D20 >> Notes execut=3DE1vel e outra >> ser=3DE1 o c=3DF3digo fonte. Penso que ambas devem vir com instaladore= s,=20 >> no c=3D >> aso=3D20 >> do fonte para que possamos >> obrigar o cara a concordar com a GPL antes de ter acesso aos fontes.=20 >> Os=3D20 >> que est=3DE3o realmente a fim >> de ajudar-nos v=3DE3o concordar e desta vez ter=3DE3o alguma=20 >> documenta=3DE7=3DE3o=3D >> do=3D20 >> c=3DF3digo a sua disposi=3DE7=3DE3o. >> >> Era wilson! Ab a todos! >> >> --=3D20 >> Anderson Rodrigues Barbieri >> -------------------------------------------- >> #Equipe do Notes - Coordenador/Desenvolvedor >> >> { TAndInfo } >> ICQ #149391850 / no...@ig... >> Notes - http://notes.codigolivre.org.br >> NotesDev - http://notes2.sf.net/dev >> F=3DF3rum - http://notes2.sf.net/forum >> >> >> --------------030708010507050300030206 >> Content-Type: text/html; charset=3Dus-ascii >> Content-Transfer-Encoding: 7bit >> >> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> >> <html> >> <head> >> <meta http-equiv=3D"Content-Type"=20 >> content=3D"text/html;charset=3DISO-8859-1"> >> <title></title> >> </head> >> <body text=3D"#000000" bgcolor=3D"#ffffff"> >> <br> >> Olá noteiros de todas as estâncias!<br> >> <br> >> Eis um início de esforço para termos uma=20 >> documentação dos fontes do >> Notes!!!<br> >> <a class=3D"moz-txt-link-freetext"=20 >> href=3D"http://notes2.sourceforge.net/dev/wakka.php?wakka=3DNotesSE200= 4">http://notes2.sourceforge.net/dev/wakka.php?wakka=3DNotesSE2004</a><br= >=20 >> >> <br> >> A partir de agora <b>POR FAVOR, TODOS</b> documentem todo o=20 >> código que >> fizerem.<br> >> Usaremos um utilitário chamado <u>pasdoc</u> pra gerar uma >> documentação, pois ele cata<br> >> os comentários do código e cria os HTMLs (exemplo feito=20 >> com os fontes >> do notes atuais<br> >> <a class=3D"moz-txt-link-freetext"=20 >> href=3D"http://notes2.sf.net/srcdocs.zip">http://notes2.sf.net/srcdocs= .zip</a>).=20 >> <br> >> <br> >> Eu compilei o pasdoc pra windows usando os fontes do CVS. Eu recomendo >> q usem está<br> >> versão q compilei (a q tá no site deles não=20 >> funciona, só dá merda).<br> >> <a class=3D"moz-txt-link-freetext"=20 >> href=3D"http://notes2.sf.net/pasdoc.zip">http://notes2.sf.net/pasdoc.z= ip</a><br>=20 >> >> O site do pasdoc é <a class=3D"moz-txt-link-freetext"=20 >> href=3D"http://pasdoc.sourceforge.net">http://pasdoc.sourceforge.net</= a><br>=20 >> >> <br> >> <br> >> <a class=3D"moz-txt-link-freetext"=20 >> href=3D"http://notes2.sourceforge.net/dev/wakka.php?wakka=3DDocumenteO= Codigo">http://notes2.sourceforge.net/dev/wakka.php?wakka=3DDocumenteOCod= igo</a><br>=20 >> >> =3D=3D=3D=3D=3D<br> >> <h2>Documente o Código</h2> >> <strong>Introdução</strong><br> >> Para facilitar a entrada de novos desenvolvedores na equipe e as >> contribuições de nossos usuários<br> >> o código fonte do Notes precisa estar documentado. Para isto=20 >> usaremos o >> <span class=3D"missingpage">PasDoc</span>, um utilitário<br> >> capaz de usar os comentários do código fonte para criar=20 >> a documentação. >> Abaixo você aprende<br> >> a documentar o código.<br> >> <br> >> <strong>Início de Unit</strong><br> >> <tt>(**<br> >> @abstract(NomeDaUnit - descrição.)<br> >> @author(PrimeiroAutor <email @do.cara=3D"">)<br> >> @author(SegundoAutor <email @do.segundo=3D"">)<br> >> Descrição mais detalhada do que a unit faz, pra que=20 >> serve,etc.<br> >> *)<br> >> unit NomeDaUnit; >> </email></email></tt><br> >> <br> >> <strong>Antes de DECLARAÇÕES de métodos, types,=20 >> constantes, records, >> etc.</strong><br> >> <tt>{descrição do que que o código faz usando um=20 >> comentário simples}<br> >> declaração do type, constante, etc.;</tt><br> >> <br> >> <strong>Variáveis</strong><br> >> <tt>nomeDaVariável: type; // pra que serve a variável,=20 >> usando >> comentário simples</tt><br> >> <br> >> <strong>procedures e funções</strong><br> >> No caso de procedures/funções nque não sejam=20 >> óbvias de entender - a >> maioria - você<br> >> deve documentar pra q servem cada um dos parâmetros e o que a=20 >> função >> retorna<br> >> <tt>(**<br> >> @param parâmetro1 descrição do que deve ser=20 >> passado.<br> >> @param parâmetro1 descrição do que deve ser=20 >> passado.<br> >> @result descrição do que é retornado, no caso de=20 >> funções.<br> >> *)<br> >> function tantam(parâmetro1, parâmetro2...): algo; >> </tt><br> >> <br> >> <strong>Conclusão</strong><br> >> é preciso ressaltar que apenas os comentários das=20 >> declarações contam, o >> resto não<br> >> aparece na documentação. É importante que=20 >> você vá comentando enquanto >> cria o<br> >> código, pois depois é um saco ter que abrir a unit e ir=20 >> comentando >> procedure por procedure!<br> >> Faça comentários objetivos. Lembre-se que um dia pode=20 >> ser que você >> mesmo acabe tendo<br> >> que ler a documentação e com certeza você=20 >> não vai querer ler algo mal >> escrito :)<br> >> <br> >> <br> >> <b></b>=3D=3D=3D=3D=3D<br> >> <br> >> A minha idéia é distribuir duas versões do Notes=20 >> SE 2004. Uma será o >> Notes executável e outra<br> >> será o código fonte. Penso que ambas devem vir com=20 >> instaladores, no >> caso do fonte para que possamos<br> >> obrigar o cara a concordar com a GPL antes de ter acesso aos fontes. O= s >> que estão realmente a fim<br> >> de ajudar-nos vão concordar e desta vez terão alguma=20 >> documentação do >> código a sua disposição.<br> >> <br> >> Era wilson! Ab a todos!<br> >> <pre cols=3D"120" class=3D"moz-signature">-- >> Anderson Rodrigues Barbieri >> -------------------------------------------- >> #Equipe do Notes - Coordenador/Desenvolvedor >> >> { TAndInfo } >> ICQ #149391850 / <a class=3D"moz-txt-link-abbreviated"=20 >> href=3D"mailto:no...@ig...">no...@ig...</a> >> Notes - <a class=3D"moz-txt-link-freetext"=20 >> href=3D"http://notes.codigolivre.org.br">http://notes.codigolivre.org.= br</a>=20 >> >> NotesDev - <a class=3D"moz-txt-link-freetext"=20 >> href=3D"http://notes2.sf.net/dev">http://notes2.sf.net/dev</a> >> Fórum - <a class=3D"moz-txt-link-freetext"=20 >> href=3D"http://notes2.sf.net/forum">http://notes2.sf.net/forum</a> >> </pre> >> </body> >> </html> >> >> --------------030708010507050300030206-- >> >> >> >> >> --__--__-- >> >> _______________________________________________ >> notes2-team mailing list >> not...@li... >> https://lists.sourceforge.net/lists/listinfo/notes2-team >> >> >> End of notes2-team Digest > > > _________________________________________________________________ > MSN Messenger: converse com os seus amigos online. =20 > http://messenger.msn.com.br > > > > ------------------------------------------------------- > This SF.net email is sponsored by: SF.net Giveback Program. > Does SourceForge.net help you be more productive? Does it > help you create better code? SHARE THE LOVE, and help us help > YOU! Click Here: http://sourceforge.net/donate/ > _______________________________________________ > notes2-team mailing list > not...@li... > https://lists.sourceforge.net/lists/listinfo/notes2-team > > --=20 Anderson Rodrigues Barbieri -------------------------------------------- #Equipe do Notes - Coordenador/Desenvolvedor { TAndInfo } ICQ #149391850 / no...@ig... Notes - http://notes.codigolivre.org.br NotesDev - http://notes2.sf.net/dev F=F3rum - http://notes2.sf.net/forum |
From: Joao V. B. de M. <joa...@ho...> - 2003-12-15 09:17:19
|
Cada Um que for fazendo a documentação, escolherá uma dupla, como foi Decidido entre eu e robson (eu dei a ideia) ele aceitou. Estamos cuidando das Areas de PHP, ASP, e Java Script. Uma pequena Observação: Troquem o sistema aqui de Listam pois minha caixa de email lé tipo assim: Usaremos um utilit=E1rio chamado _pasdoc_ pra gerar uma documenta=E7=E3o,= pois=20 ele cata os coment=E1rios do c=F3digo e cria os HTMLs (exemplo feito com os fontes= do=20 Ai esta commplicando muito para mim ler. Obrigado >From: not...@li... >Reply-To: not...@li... >To: not...@li... >Subject: notes2-team digest, Vol 1 #247 - 2 msgs >Date: Sun, 14 Dec 2003 20:09:13 -0800 > >Send notes2-team mailing list submissions to > not...@li... > >To subscribe or unsubscribe via the World Wide Web, visit > https://lists.sourceforge.net/lists/listinfo/notes2-team >or, via email, send a message with subject or body 'help' to > not...@li... > >You can reach the person managing the list at > not...@li... > >When replying, please edit your Subject line so it is more specific >than "Re: Contents of notes2-team digest..." > > >Today's Topics: > > 1. ** =?ISO-8859-1?Q?Documenta=E7=E3o_dos_fontes_do_Notes_?= > =?ISO-8859-1?Q?**?= (Anderson R. Barbieri) > >--__--__-- > >Message: 1 >Date: Mon, 15 Dec 2003 01:50:25 -0200 >From: "Anderson R. Barbieri" <no...@ig...> >To: not...@li... >Subject: [Notes2-team] ** >=?ISO-8859-1?Q?Documenta=E7=E3o_dos_fontes_do_Notes_?= > =?ISO-8859-1?Q?**?= >Reply-To: not...@li... > >This is a multi-part message in MIME format. >--------------030708010507050300030206 >Content-Type: text/plain; charset=ISO-8859-1; format=flowed >Content-Transfer-Encoding: quoted-printable > > >Ol=E1 noteiros de todas as est=E2ncias! > >Eis um in=EDcio de esfor=E7o para termos uma documenta=E7=E3o dos fontes = >do Notes!!! >http://notes2.sourceforge.net/dev/wakka.php?wakka=3DNotesSE2004 > >A partir de agora *POR FAVOR, TODOS* documentem todo o c=F3digo que fizer= >em. >Usaremos um utilit=E1rio chamado _pasdoc_ pra gerar uma documenta=E7=E3o,= > pois=20 >ele cata >os coment=E1rios do c=F3digo e cria os HTMLs (exemplo feito com os fontes= > do=20 >notes atuais >http://notes2.sf.net/srcdocs.zip). > >Eu compilei o pasdoc pra windows usando os fontes do CVS. Eu recomendo q=20 >usem est=E1 >vers=E3o q compilei (a q t=E1 no site deles n=E3o funciona, s=F3 d=E1 mer= >da). >http://notes2.sf.net/pasdoc.zip >O site do pasdoc =E9 http://pasdoc.sourceforge.net > > >http://notes2.sourceforge.net/dev/wakka.php?wakka=3DDocumenteOCodigo >=3D=3D=3D=3D=3D > > > Documente o C=F3digo > >*Introdu=E7=E3o* >Para facilitar a entrada de novos desenvolvedores na equipe e as=20 >contribui=E7=F5es de nossos usu=E1rios >o c=F3digo fonte do Notes precisa estar documentado. Para isto usaremos o= >=20 >PasDoc, um utilit=E1rio >capaz de usar os coment=E1rios do c=F3digo fonte para criar a documenta=E7= >=E3o.=20 >Abaixo voc=EA aprende >a documentar o c=F3digo. > >*In=EDcio de Unit* >(** >@abstract(NomeDaUnit - descri=E7=E3o.) >@author(PrimeiroAutor ) >@author(SegundoAutor ) >Descri=E7=E3o mais detalhada do que a unit faz, pra que serve,etc. >*) >unit NomeDaUnit; > >*Antes de DECLARA=C7=D5ES de m=E9todos, types, constantes, records, etc.* >{descri=E7=E3o do que que o c=F3digo faz usando um coment=E1rio simples} >declara=E7=E3o do type, constante, etc.; > >*Vari=E1veis* >nomeDaVari=E1vel: type; // pra que serve a vari=E1vel, usando coment=E1ri= >o simples > >*procedures e fun=E7=F5es* >No caso de procedures/fun=E7=F5es nque n=E3o sejam =F3bvias de entender -= > a=20 >maioria - voc=EA >deve documentar pra q servem cada um dos par=E2metros e o que a fun=E7=E3= >o retorna >(** >@param par=E2metro1 descri=E7=E3o do que deve ser passado. >@param par=E2metro1 descri=E7=E3o do que deve ser passado. >@result descri=E7=E3o do que =E9 retornado, no caso de fun=E7=F5es. >*) >function tantam(par=E2metro1, par=E2metro2...): algo; > >*Conclus=E3o* >=E9 preciso ressaltar que apenas os coment=E1rios das declara=E7=F5es con= >tam, o=20 >resto n=E3o >aparece na documenta=E7=E3o. =C9 importante que voc=EA v=E1 comentando en= >quanto cria o >c=F3digo, pois depois =E9 um saco ter que abrir a unit e ir comentando=20 >procedure por procedure! >Fa=E7a coment=E1rios objetivos. Lembre-se que um dia pode ser que voc=EA = >mesmo=20 >acabe tendo >que ler a documenta=E7=E3o e com certeza voc=EA n=E3o vai querer ler algo= > mal=20 >escrito :) > > >**=3D=3D=3D=3D=3D > >A minha id=E9ia =E9 distribuir duas vers=F5es do Notes SE 2004. Uma ser=E1= > o=20 >Notes execut=E1vel e outra >ser=E1 o c=F3digo fonte. Penso que ambas devem vir com instaladores, no c= >aso=20 >do fonte para que possamos >obrigar o cara a concordar com a GPL antes de ter acesso aos fontes. Os=20 >que est=E3o realmente a fim >de ajudar-nos v=E3o concordar e desta vez ter=E3o alguma documenta=E7=E3o= > do=20 >c=F3digo a sua disposi=E7=E3o. > >Era wilson! Ab a todos! > >--=20 >Anderson Rodrigues Barbieri >-------------------------------------------- >#Equipe do Notes - Coordenador/Desenvolvedor > >{ TAndInfo } >ICQ #149391850 / no...@ig... >Notes - http://notes.codigolivre.org.br >NotesDev - http://notes2.sf.net/dev >F=F3rum - http://notes2.sf.net/forum > > >--------------030708010507050300030206 >Content-Type: text/html; charset=us-ascii >Content-Transfer-Encoding: 7bit > ><!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> ><html> ><head> > <meta http-equiv="Content-Type" content="text/html;charset=ISO-8859-1"> > <title></title> ></head> ><body text="#000000" bgcolor="#ffffff"> ><br> >Olá noteiros de todas as estâncias!<br> ><br> >Eis um início de esforço para termos uma >documentação dos fontes do >Notes!!!<br> ><a class="moz-txt-link-freetext" >href="http://notes2.sourceforge.net/dev/wakka.php?wakka=NotesSE2004">http://notes2.sourceforge.net/dev/wakka.php?wakka=NotesSE2004</a><br> ><br> >A partir de agora <b>POR FAVOR, TODOS</b> documentem todo o código >que >fizerem.<br> >Usaremos um utilitário chamado <u>pasdoc</u> pra gerar uma >documentação, pois ele cata<br> >os comentários do código e cria os HTMLs (exemplo feito com >os fontes >do notes atuais<br> ><a class="moz-txt-link-freetext" >href="http://notes2.sf.net/srcdocs.zip">http://notes2.sf.net/srcdocs.zip</a>). ><br> ><br> >Eu compilei o pasdoc pra windows usando os fontes do CVS. Eu recomendo >q usem está<br> >versão q compilei (a q tá no site deles não funciona, >só dá merda).<br> ><a class="moz-txt-link-freetext" >href="http://notes2.sf.net/pasdoc.zip">http://notes2.sf.net/pasdoc.zip</a><br> >O site do pasdoc é <a class="moz-txt-link-freetext" >href="http://pasdoc.sourceforge.net">http://pasdoc.sourceforge.net</a><br> ><br> ><br> ><a class="moz-txt-link-freetext" >href="http://notes2.sourceforge.net/dev/wakka.php?wakka=DocumenteOCodigo">http://notes2.sourceforge.net/dev/wakka.php?wakka=DocumenteOCodigo</a><br> >=====<br> ><h2>Documente o Código</h2> ><strong>Introdução</strong><br> >Para facilitar a entrada de novos desenvolvedores na equipe e as >contribuições de nossos usuários<br> >o código fonte do Notes precisa estar documentado. Para isto >usaremos o ><span class="missingpage">PasDoc</span>, um utilitário<br> >capaz de usar os comentários do código fonte para criar a >documentação. >Abaixo você aprende<br> >a documentar o código.<br> ><br> ><strong>Início de Unit</strong><br> ><tt>(**<br> >@abstract(NomeDaUnit - descrição.)<br> >@author(PrimeiroAutor <email @do.cara="">)<br> >@author(SegundoAutor <email @do.segundo="">)<br> >Descrição mais detalhada do que a unit faz, pra que >serve,etc.<br> >*)<br> >unit NomeDaUnit; ></email></email></tt><br> ><br> ><strong>Antes de DECLARAÇÕES de métodos, types, >constantes, records, >etc.</strong><br> ><tt>{descrição do que que o código faz usando um >comentário simples}<br> >declaração do type, constante, etc.;</tt><br> ><br> ><strong>Variáveis</strong><br> ><tt>nomeDaVariável: type; // pra que serve a variável, usando >comentário simples</tt><br> ><br> ><strong>procedures e funções</strong><br> >No caso de procedures/funções nque não sejam >óbvias de entender - a >maioria - você<br> >deve documentar pra q servem cada um dos parâmetros e o que a >função >retorna<br> ><tt>(**<br> >@param parâmetro1 descrição do que deve ser >passado.<br> >@param parâmetro1 descrição do que deve ser >passado.<br> >@result descrição do que é retornado, no caso de >funções.<br> >*)<br> >function tantam(parâmetro1, parâmetro2...): algo; ></tt><br> ><br> ><strong>Conclusão</strong><br> >é preciso ressaltar que apenas os comentários das >declarações contam, o >resto não<br> >aparece na documentação. É importante que você >vá comentando enquanto >cria o<br> >código, pois depois é um saco ter que abrir a unit e ir >comentando >procedure por procedure!<br> >Faça comentários objetivos. Lembre-se que um dia pode ser que >você >mesmo acabe tendo<br> >que ler a documentação e com certeza você não >vai querer ler algo mal >escrito :)<br> ><br> ><br> ><b></b>=====<br> ><br> >A minha idéia é distribuir duas versões do Notes SE >2004. Uma será o >Notes executável e outra<br> >será o código fonte. Penso que ambas devem vir com >instaladores, no >caso do fonte para que possamos<br> >obrigar o cara a concordar com a GPL antes de ter acesso aos fontes. Os >que estão realmente a fim<br> >de ajudar-nos vão concordar e desta vez terão alguma >documentação do >código a sua disposição.<br> ><br> >Era wilson! Ab a todos!<br> ><pre cols="120" class="moz-signature">-- >Anderson Rodrigues Barbieri >-------------------------------------------- >#Equipe do Notes - Coordenador/Desenvolvedor > >{ TAndInfo } >ICQ #149391850 / <a class="moz-txt-link-abbreviated" >href="mailto:no...@ig...">no...@ig...</a> >Notes - <a class="moz-txt-link-freetext" >href="http://notes.codigolivre.org.br">http://notes.codigolivre.org.br</a> >NotesDev - <a class="moz-txt-link-freetext" >href="http://notes2.sf.net/dev">http://notes2.sf.net/dev</a> >Fórum - <a class="moz-txt-link-freetext" >href="http://notes2.sf.net/forum">http://notes2.sf.net/forum</a> ></pre> ></body> ></html> > >--------------030708010507050300030206-- > > > > >--__--__-- > >_______________________________________________ >notes2-team mailing list >not...@li... >https://lists.sourceforge.net/lists/listinfo/notes2-team > > >End of notes2-team Digest _________________________________________________________________ MSN Messenger: converse com os seus amigos online. http://messenger.msn.com.br |
From: Anderson R. B. <no...@ig...> - 2003-12-15 03:43:11
|
Ol=E1 noteiros de todas as est=E2ncias! Eis um in=EDcio de esfor=E7o para termos uma documenta=E7=E3o dos fontes = do Notes!!! http://notes2.sourceforge.net/dev/wakka.php?wakka=3DNotesSE2004 A partir de agora *POR FAVOR, TODOS* documentem todo o c=F3digo que fizer= em. Usaremos um utilit=E1rio chamado _pasdoc_ pra gerar uma documenta=E7=E3o,= pois=20 ele cata os coment=E1rios do c=F3digo e cria os HTMLs (exemplo feito com os fontes= do=20 notes atuais http://notes2.sf.net/srcdocs.zip). Eu compilei o pasdoc pra windows usando os fontes do CVS. Eu recomendo q=20 usem est=E1 vers=E3o q compilei (a q t=E1 no site deles n=E3o funciona, s=F3 d=E1 mer= da). http://notes2.sf.net/pasdoc.zip O site do pasdoc =E9 http://pasdoc.sourceforge.net http://notes2.sourceforge.net/dev/wakka.php?wakka=3DDocumenteOCodigo =3D=3D=3D=3D=3D Documente o C=F3digo *Introdu=E7=E3o* Para facilitar a entrada de novos desenvolvedores na equipe e as=20 contribui=E7=F5es de nossos usu=E1rios o c=F3digo fonte do Notes precisa estar documentado. Para isto usaremos o= =20 PasDoc, um utilit=E1rio capaz de usar os coment=E1rios do c=F3digo fonte para criar a documenta=E7= =E3o.=20 Abaixo voc=EA aprende a documentar o c=F3digo. *In=EDcio de Unit* (** @abstract(NomeDaUnit - descri=E7=E3o.) @author(PrimeiroAutor ) @author(SegundoAutor ) Descri=E7=E3o mais detalhada do que a unit faz, pra que serve,etc. *) unit NomeDaUnit; *Antes de DECLARA=C7=D5ES de m=E9todos, types, constantes, records, etc.* {descri=E7=E3o do que que o c=F3digo faz usando um coment=E1rio simples} declara=E7=E3o do type, constante, etc.; *Vari=E1veis* nomeDaVari=E1vel: type; // pra que serve a vari=E1vel, usando coment=E1ri= o simples *procedures e fun=E7=F5es* No caso de procedures/fun=E7=F5es nque n=E3o sejam =F3bvias de entender -= a=20 maioria - voc=EA deve documentar pra q servem cada um dos par=E2metros e o que a fun=E7=E3= o retorna (** @param par=E2metro1 descri=E7=E3o do que deve ser passado. @param par=E2metro1 descri=E7=E3o do que deve ser passado. @result descri=E7=E3o do que =E9 retornado, no caso de fun=E7=F5es. *) function tantam(par=E2metro1, par=E2metro2...): algo; *Conclus=E3o* =E9 preciso ressaltar que apenas os coment=E1rios das declara=E7=F5es con= tam, o=20 resto n=E3o aparece na documenta=E7=E3o. =C9 importante que voc=EA v=E1 comentando en= quanto cria o c=F3digo, pois depois =E9 um saco ter que abrir a unit e ir comentando=20 procedure por procedure! Fa=E7a coment=E1rios objetivos. Lembre-se que um dia pode ser que voc=EA = mesmo=20 acabe tendo que ler a documenta=E7=E3o e com certeza voc=EA n=E3o vai querer ler algo= mal=20 escrito :) **=3D=3D=3D=3D=3D A minha id=E9ia =E9 distribuir duas vers=F5es do Notes SE 2004. Uma ser=E1= o=20 Notes execut=E1vel e outra ser=E1 o c=F3digo fonte. Penso que ambas devem vir com instaladores, no c= aso=20 do fonte para que possamos obrigar o cara a concordar com a GPL antes de ter acesso aos fontes. Os=20 que est=E3o realmente a fim de ajudar-nos v=E3o concordar e desta vez ter=E3o alguma documenta=E7=E3o= do=20 c=F3digo a sua disposi=E7=E3o. Era wilson! Ab a todos! --=20 Anderson Rodrigues Barbieri -------------------------------------------- #Equipe do Notes - Coordenador/Desenvolvedor { TAndInfo } ICQ #149391850 / no...@ig... Notes - http://notes.codigolivre.org.br NotesDev - http://notes2.sf.net/dev F=F3rum - http://notes2.sf.net/forum |
From: Jonas R. S. S. <jon...@bo...> - 2003-12-12 22:46:06
|
Primeiramente eu tava pensano: a dll do shellext deve conter apenas chamadas para outras coisas externas, seu =FAnico objetivo eh mostrar os menuzim e naum processar nada (toh com mania de fazer coisas gen=E9ricas)... Mas pensando bem... Pq naum colocar o c=F3digo lah memo neh??? Qto a dll, tah certo... Eh q eu toh com o pensamento mto gen=E9rico memo huhu, tava pensano em usar isso em outras coisas mais a frente, mas xah keto :b _________________________________________=20 =BB Jonas Raoni Soares Silva=20 =BB=BB Delphi & Web Developer=20 =BB jon...@bo...=20 =BB=BB icq#: 84645392=20 =BB +55(11)6702-0233=20 _________________________________________ > -----Mensagem original----- > De: not...@li...=20 >=20 > Acho que n=E3o tem por que n=E3o colocar > o c=F3digo na shellextension. Pq? >=20 > 1. Criar uma DLL ou outro execut=E1vel para apenas uma fun=E7=E3o > n=E3o faz nehum sentido (tudo fica mais lerdo e mais pesado). > 2. N=E3o h=E1 pq colocar outras fun=E7=F5es no DLL/execut=E1vel al=E9m = > desta pois =E9 a =FAnica que estar=E1 na shellextension e no notes=20 > ao mesmo tempo 3. Essa fun=E7=E3o provavelmente n=E3o sofrer=E1=20 > modifica=E7=F5es daqui pra frente >=20 > Prefiro n=E3o colocar a op=E7=E3o na shellext do que ter que criar=20 > mais um DLL ou execut=E1vel... se n=E3o quiserem colocar o c=F3digo=20 > dentro da shellext, ent=E3o tiramos a op=E7=E3o. Um DLL/Execut=E1vel=20 > a mais quer dizer mais 130 kb que ser=E3o completamente in=FAteis... >=20 > Ab. > Anderson |
From: Anderson R. B. <no...@ig...> - 2003-12-12 15:28:17
|
Esse espa=E7o sobrando =E9 normal e n=E3o tem como ser evitado. D=EA uma = olhada em di=E1logos de configura=E7=E3o de outros programas (ex: dreamweaver, e= clipse) e voc=EA vai ver que eles tb=E9m tem tabs com mt espa=E7o sobrando... iss= o=20 naum tem jeito naum. Mas tb=E9m naum gosto, heheheheh Ab. And. Victor Thiago Bartz H=F6her wrote: > =E9 pra dar opini=E3o n=E9..entao la vai..tao legal eles, acho que nao = tem=20 > muito o que comentar....mas esse neg=F3cio dos dialogos estarem=20 > "grand=E3o" em altura ficou meio estranho nos forms 1 e 2 n=E3o? ficou = uns=20 > espa=E7os vazios ali, se bem que n=E3o tem como dminur por causa do=20 > tamanho do 1.....ia ficar diferente..ia ser mais estranho=20 > ainda..talvez se inserir alguma coisa ali nos espa=E7os vazios....tipo=20 > um jogo da velha....hahahahahaha sei l=E1 eras isso > Anderson R. Barbieri wrote: --=20 Anderson Rodrigues Barbieri -------------------------------------------- #Equipe do Notes - Coordenador/Desenvolvedor { TAndInfo } ICQ #149391850 / no...@ig... Notes - http://notes.codigolivre.org.br NotesDev - http://notes2.sf.net/dev F=F3rum - http://notes2.sf.net/forum |
From: Anderson R. B. <no...@ig...> - 2003-12-12 15:24:07
|
Jonas Raoni Soares Silva wrote: >Hmmm, interessante isso ae :] > >Eu naum zoiei direito ainda, como funciona??? O parser funciona dentro >do programa ou =E9 "din=E2mico" (tipo vc cria um arquivo xyz contendo >especifica=E7=F5es da estrutura da linguagem a ser processada)??? > =20 > Ambos! Pelo que vi do c=F3digo, existe um parser "gen=E9rico" que depois = =E9=20 filtrado por parser espec=EDficos para cada linguagem. Os parsers espec=EDficos servem para dizer "isto =E9= =20 uma fun=E7=E3o", "isto =E9 uma classe", etc. Esses parser espec=EDficos s=E3o hardcodec... existem parsers hardcoded p= ara=20 quase tudo quanto =E9 linguagem e n=E3o parece ser complicado adicionar para as que n=E3o exist= em=20 e recompilar... eu naum sei quase nada de "C", mas o c=F3digo =E9 taum simplesim que at=E9 eu me animo a da= r uma=20 mexidas, hahahahah Existem algo como "parsers din=E2micos", mas eles saum ruinzim. O que voc= =EA=20 pode =E9 criar um arquivo de configura=E7=E3o pro ctags no seu diret=F3rio home e dizer que o ctags de= ve=20 buscar em arquivos com uma certa extens=E3o por uma determinada express=E3o regular... a coisa fica mt=20 fraquinha. Acho que tamb=E9m chega um momento em que n=E3o podemos agradar a todos. = =C9=20 melhorar ter um bom parser para todas as linguagens mais usadas do que n=E3o ter parser=20 nehum ou um parser ruim para todas elas. Mas temos que pensar bastante sobre isto ainda..... >Obs: Ah, uma coisa q eu toh pra perguntar faz moh cara... Qual foi a >inten=E7=E3o ao deixar o treco no SourceForge? Facilitar a participa=E7=E3= o do >povo de fora ou apenas servir como host??? > =20 > Servir como Host. O Notes tava tendo download demais e o admin do=20 c=F3digolivre tava meio preocupado com isso, ent=E3o criei o dom=EDnio do sf para podermos ter ma= is=20 mirrors. Depois o sistema de lista de e-mails do SF =E9 melhor, e o SF deixa a gente mandar= =20 arquivos para o site por SSH (rapidim) enquanto o CL apenas pelo browser (muuuiiittto lerdo,=20 al=E9m de chato). Ab. And. |
From: Anderson R. B. <no...@ig...> - 2003-12-12 15:09:52
|
Acho que n=E3o tem por que n=E3o colocar o c=F3digo na shellextension. Pq? 1. Criar uma DLL ou outro execut=E1vel para apenas uma fun=E7=E3o n=E3o faz nehum sentido (tudo fica mais lerdo e mais pesado). 2. N=E3o h=E1 pq colocar outras fun=E7=F5es no DLL/execut=E1vel al=E9m de= sta pois =E9 a =FAnica que estar=E1 na shellextension e no notes ao mesmo tem= po 3. Essa fun=E7=E3o provavelmente n=E3o sofrer=E1 modifica=E7=F5es daqui p= ra frente Prefiro n=E3o colocar a op=E7=E3o na shellext do que ter que criar mais u= m DLL ou execut=E1vel... se n=E3o quiserem colocar o c=F3digo dentro da shellex= t, ent=E3o tiramos a op=E7=E3o. Um DLL/Execut=E1vel a mais quer dizer mais 130 kb qu= e ser=E3o completamente in=FAteis... Ab. Anderson Jonas Raoni Soares Silva wrote: >Agora eu naum sei tb hehe :b > >Vou colocar mais d=FAvida nessa quest=E3o huhu =3DP > >- Colocar o c=F3digo na DLL do ShellExt naum acho q seja uma boa tb :b >- O melhor seria bindar isso ae no execut=E1vel memo, pq dae tudo ficari= a >centralizado e talz (menos trabalho para posteriores manuten=E7=F5es...) >- Se bem q fazer uma dll soh para isso =E9 a melhor op=E7=E3o em termos = de >velocidade, obrigar o kra a esperar o notes carregar soh para executar >uma tarefa extremamente r=E1pida eh fogo (se bem q isso pode ser >contornado adicionando a checagem de par=E2metros no dpr) :b >- Outra op=E7=E3o seria fazer um programinha/dll soh com as coisas >b=E1sicas... Eu digo coisas q soh tem processamento (sem GUI no meio...)= , >pode at=E9 ser um prog em forma de console jah q naum vai ter interface >memo :] > >Obs: Aeee passei em segundo na faku haeuheauheaaeu =3D] > >Jonas Raoni Soares Silva >----------------------------------- >#Equipe do Notes - Desenvolvimento > > >-----Mensagem original----- >De: not...@li... >[mailto:not...@li...] Em nome de Daniel Roma > >Ahhhhhrg! Algu=E9m mata meu chefe por favor!!!!! > >humpf! > >Bom, consegui alguns segundos pra escrever um e-mailzinho... :) >Anderson, n=E3o acho legal colocar o comprimir HTML como c=F3digo dentro= do >Shell Extension, pq seria replica=E7=E3o.... depois, se formos mudar alg= uma >coisa nesse algor=EDtmo, ter=EDamos que mudar nos dois lugares, isso se >lembrarmos que tinha l=E1 tbem... ent=E3o proponho que estes c=F3digos >"compartilhados" entre o Shell Ext e o Notes em si sejam colocados numa >DLL (n=E3o gosto muito dessa solu=E7=E3o, mas seria o mais correto), ou >colocar um par=E2metro no notes (-c por exemplo) para que o pr=F3prio no= tes >fa=E7a o servi=E7o... que acham? > > >[]=B4s > >Daniel Roma >#Equipe do Notes - Desenvolvimento > > > > >------------------------------------------------------- >This SF.net email is sponsored by: SF.net Giveback Program. >Does SourceForge.net help you be more productive? Does it >help you create better code? SHARE THE LOVE, and help us help >YOU! Click Here: http://sourceforge.net/donate/ >_______________________________________________ >notes2-team mailing list >not...@li... >https://lists.sourceforge.net/lists/listinfo/notes2-team > > > =20 > --=20 Anderson Rodrigues Barbieri -------------------------------------------- #Equipe do Notes - Coordenador/Desenvolvedor { TAndInfo } ICQ #149391850 / no...@ig... Notes - http://notes.codigolivre.org.br NotesDev - http://notes2.sf.net/dev F=F3rum - http://notes2.sf.net/forum |