Help FreeCAD/pt-br: Difference between revisions

From FreeCAD Documentation
(Created page with "== Trabalhe na documentação ==")
(Updating to match new version of source page)
 
(46 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{TOCright}}

==Introdução==
==Introdução==


<div class="mw-translate-fuzzy">
{{TOCright}}
Se gosta do FreeCAD e gostaria de ajudar no seu desenvolvimento, para além de [[Special:MyLanguage/Donate|doações]], há muitas outras coisas que pode fazer, mesmo que não sendo um programador.
</div>


== Donate money ==
Se gosta do FreeCAD e gostaria de ajudar no seu desenvolvimento, para além de [[Donate|doações]], há muitas outras coisas que pode fazer, mesmo que não sendo um programador.

Although FreeCAD doesn't need money to be developed, donations can help the project to grow further and faster. The [[Donate|Donate]] page lists all the options you have to donate money to the project.


== Trabalhe na documentação ==
== Trabalhe na documentação ==


Help us to build, correct and extend this documentation. Correct mistakes, extend or correct pages that are unclear, create new pages if a topic is missing, etc. Contributing to the FreeCAD wiki is easy, at [[WikiPages|WikiPages]] you can find the general guidelines and the help needed to get you started. To edit the wiki, you will need a wiki account with "Editor" permissions (the wiki is write-protected to avoid spamming). You can ask for an account [http://forum.freecadweb.org/viewtopic.php?f=21&t=6830 on the forum] or on the [https://wiki.freecadweb.org/Help#Chat IRC channel]. Please note that the IRC channel may not be as responsive as the forum. [https://forum.freecadweb.org The official FreeCAD forum] should be the premier place to ask questions and start discussions, As it will help preserve the experience and knowledge of the community.
Ajude-nos a construir, corrigir e ampliar esta documentação. Corrigir erros, estender ou corrigir páginas que não estejam claras, criar novas páginas se faltar um tópico, etc. Contribuir para o wiki do FreeCAD é fácil, em [[Special:MyLanguage/WikiPages|PaginasWiki]] você pode encontrar as diretrizes gerais e a ajuda necessária para começar. Para editar o wiki, você precisará de uma conta wiki com permissões de "Editor" (o wiki é protegido contra gravação para evitar ‘spam’). Pode solicitar uma conta [http://forum.freecadweb.org/viewtopic.php?f=21&t=6830|no fórum] ou no [https://wiki.freecadweb.org/Help#Chat|canal IRC]. Note que o canal do IRC pode não ser tão responsivo como o fórum. [https://forum.freecadweb.org O fórum oficial do FreeCAD] deve ser o local principal para fazer perguntas e iniciar discussões, pois ajudará a preservar a experiência e o conhecimento da comunidade.


<div class="mw-translate-fuzzy">
A couple of areas that would welcome your work:
Algumas áreas indicadas para iniciar o trabalho:
* The [[:Category:Command Reference]] page lists and documents all of the FreeCAD [[command|command]]s. Most of them contain little to no information at all. Please refer to [[WikiPages|WikiPages]] for good examples of what command documentation pages should look like.
* A página [[Special:MyLanguage/:Category:Command Reference|:Categoria:Referência de Comando]] lista e documenta todos os [[Special:MyLanguage/command|comando]]s do FreeCAD. A maioria deles contém pouca ou nenhuma informação. Por favor, consulte [[Special:MyLanguage/WikiPages|PaginasWiki]] para bons exemplos de como devem ser as páginas de documentação de comandos.
* The [[Tutorials|Tutorials]] section needs examples on how to use the workbenches. If you developed something cool with FreeCAD, why not document how you did it for posterity?
* A seção [[Special:MyLanguage/Tutorials|Tutoriais]] precisa de exemplos sobre como utilizar as bancadas de trabalho. Se desenvolveu algo interessante com o FreeCAD, porque não documentar como o fez para a posteridade?
* There are open tickets on the FreeCAD [[bugtracker|bugtracker]] tagged [https://freecadweb.org/tracker/search.php?tag_string=documentation "documentation"] that could use some love.
*Existem entradas pendentes no [[Special:MyLanguage/bugtracker|rastreador de erros]] marcadas como [https://freecadweb.org/tracker/search.php?tag_string=documentation "documentation"] use com amor.
</div>


== Partilhe o seu conhecimento do FreeCAD ==
== Share your FreeCAD knowledge ==


<div class="mw-translate-fuzzy">
The user community around FreeCAD is still small, but already includes several advanced users who do a very important job in showing to newcomers how to use the software. If you begin to feel comfortable with FreeCAD, your knowledge could be very valuable to others, and you might
A comunidade de usuários em torno do FreeCAD ainda é pequena, mas já inclui vários usuários avançados que fazem um trabalho muito importante para mostrar aos recém-chegados como utilizar o ‘software’. Se começar a sentir-se confortável com o FreeCAD, os seus conhecimentos poderão ser muito valiosos para outros, e poderá contribuir com recursos importantes como, por exemplo:
contribute with important assets, like:
* Showing the work you do with FreeCAD on the [http://forum.freecadweb.org/viewforum.php?f=24 Users Showcase forum]. You can post screenshots, and, even better, attach the FreeCAD files so other people can examine it and understand how you did it.
* Mostrando o trabalho que fez com o FreeCAD no fórum [http://forum.freecadweb.org/viewforum.php?f=24 'Users Showcase forum']. Pode colocar capturas de tela e melhor ainda se anexar os arquivos do FreeCAD, para que outras pessoas possam examiná-lo e compreender como foi feito.
* Recording [http://www.youtube.com/user/FreeCADNews videos] showing how you did something interesting in FreeCAD. These videos usually do a great job in showing new features.
* Gravar [http://www.youtube.com/user/FreeCADNews vídeos] mostrando como fez algo interessante no FreeCAD. Estes vídeos fazem normalmente um excelente trabalho mostrando novas funcionalidades.
* Write [http://freecad-tutorial.blogspot.com/ tutorials] describing or teaching something interesting. You can write tutorials on your own blog, directly on our wiki, or even on the forum.
* Escrever [http://freecad-tutorial.blogspot.com/ tutoriais] descrevendo ou ensinando algo interessante. Pode escrever tutoriais no seu próprio "blog", diretamente no nosso wiki, ou mesmo no fórum.
* Post on the [https://joinmastodon.org/ Mastodon] open source social network (and [https://fosstodon.org/@FreeCAD follow FreeCAD] there) or on the [https://www.facebook.com/groups/416491481766626 Facebook] community.
* Publique na rede social de código aberto [https://joinmastodon.org/ Mastodon](e [https://fosstodon.org/@FreeCAD siga o FreeCAD lá]) ou na comunidade do [https://www.facebook.com/groups/416491481766626 Facebook].
* Look into the latest FreeCAD posts on [https://www.reddit.com/search/?q=freecad&type=link&sort=new Reddit], [https://3dprinting.stackexchange.com/search?tab=newest&q=freecad 3dprinting.stackexchange], [https://stackoverflow.com/search?q=freecad StackOverflow]... Try to answer them and participate in the discussions sharing your experience and information.
* Veja os últimos posts FreeCAD no [https://www.reddit.com/search/?q=freecad&type=link&sort=new Reddit], [https://3dprinting.stackexchange.com/search?tab=newest&q=freecad 3dprinting.stackexchange], [https://stackoverflow.com/search?q=freecad StackOverflow]... Tente responder e participe das discussões partilhando a sua experiência e informação.
* Be present at the FreeCAD IRC channel or [https://www.freecadweb.org/wiki/Help#Chat other chat groups]
* Participar do canal IRC FreeCAD ou [https://www.freecadweb.org/wiki/Help#Chat outras salas de conversa].
</div>


== Translate FreeCAD ==
== Traduza o FreeCAD ==


Translate FreeCAD to your own language. All text strings of the FreeCAD interface can be easily translated to other languages. All we need is someone who knows that other languages and is willing to help! All the translations are done online on [http://crowdin.net/project/freecad Crowdin].
Localize o FreeCAD para a sua língua. Todas as cadeias de texto da interface do FreeCAD podem ser facilmente traduzidas para outras línguas. Tudo o que precisamos é de alguém que saiba outras línguas e esteja disposto a ajudar! Todas as traduções são feitas online em [http://crowdin.net/project/freecad Crowdin].


For details on translation, see [[Localisation|Localisation]].
Para mais detalhes sobre a tradução, consulte [[Special:MyLanguage/Localisation|Localização]].


== Translate the documentation ==
== Traduza a documentação ==


Translating is easy, the FreeCAD wiki supports a translation plugin which allows you to translate the base English page to other languages.
Traduzir é fácil, o wiki FreeCAD suporta um "plugin" de tradução que lhe permite traduzir a página base em inglês para outras línguas.


For details on translation, see [[Localisation#Translating the wiki]].
Para detalhes sobre tradução, consulte [[Special:MyLanguage/Localisation#Translate the FreeCAD wiki|Localização#Traduzindo o wiki do FreeCAD]].


Please be sure you are familiar with the basics of wiki markup; see [[Help:Editing|Help:Editing]] for a reference.
Por favor, certifique-se de que está familiarizado com os fundamentos de marcação wiki; ver [[Special:MyLanguage/Help:Editing|Ajuda:Editando]] como referência.


Then head to [[WikiPages|WikiPages]] to familiarize yourself with the style used in this wiki, particularly when it comes to templates.
Depois dirija-se a [[Special:MyLanguage/WikiPages|PáginasWiki]] para se familiarizar com o estilo utilizado neste wiki, particularmente quando se trata de modelos.


== Help others to know FreeCAD ==
== Ajudar os outros a conhecer o FreeCAD ==


* Talk about FreeCAD to other people who might be interested
* Fale sobre o FreeCAD a outras pessoas que possam ter interesse.
* Find interesting uses for FreeCAD, and document it, for example with screenshots. FreeCAD is very young, and not many people see what they can do with it. If you are a FreeCAD fan already, you surely know some cool thing FreeCAD can do. Help us to show that to others!
* Se encontrar usos interessantes para o FreeCAD, documente-os, usando capturas de tela como exemplo. O FreeCAD é bastante jovem, e muitas pessoas não imaginam o que se pode fazer com ele. Se é um do FreeCAD, certamente sabe algo legal que o FreeCAD pode fazer. Ajude-nos a mostrar isso a outros!
* De uma passada no fórum e ajude os recém-chegados a resolver questões básicas.
* Hang on the forum, and help newcomers to solve basic questions
* Write tutorials, record videos, etc., showing what you do with FreeCAD
* Escreva tutoriais, grave vídeos, etc., mostrando o que se pode fazer com o FreeCAD.
* Contribute with files, drawings, etc. We still lack good example files of what can be done with FreeCAD
* Contribuir com arquivos, desenhos, etc. Ainda faltam bons arquivos de exemplo do que pode ser feito com o FreeCAD.
* Help to promote FreeCAD on GitHub by [https://help.github.com/articles/be-social/#watch-a-project "Starring" and "Watching"] the [https://github.com/FreeCAD/FreeCAD FreeCAD repository]
* Ajuda para promover o FreeCAD no GitHub dando [https://help.github.com/articles/be-social/#watch-a-project "Estrela" e "Observando"] o [https://github.com/FreeCAD/FreeCAD repositório FreeCAD]


== Reportar falhas e solicitar funcionalidades interessantes ==
== Report bugs and ask for interesting features ==


[[File:Bugreport-workflow.png|center]]
[[File:Bugreport-workflow.png|center]]


Embora o local para relatar erros confirmados e sugerir novas funcionalidades seja eventualmente o '''[[Special:MyLanguage/tracker| rastreador de erros do FreeCAD]]''', por favor, publique sempre primeiro os relatórios de erros e pedidos de funcionalidades no fórum. De modo a poupar tempo aos programadores (triagem e tratamento de erros difíceis de compreender podem ser muito demorados), e evitar frustrações porque o seu problema não foi tratado da forma que gostaria, por favor leia o seguinte:
Although the place to report confirmed bugs and suggest new features is eventually the '''[[tracker|FreeCAD Tracker]]''', please always post bug reports and feature requests to the Help forum first. In order to save developers time (triaging and handling hard to understand bugs can be very time consuming), and avoid frustrations because your issue was not handled the way you would like, please read the following:
* Bugs and features requests are handled in the same tracker. Just mark your issue as "bug" (something that doesn't work as it should) or "feature" (something that is not there but you think it would be good to have)
* Erros e pedidos de funcionalidades são tratados no mesmo rastreador. Basta marcar o seu problema como "bug" (algo que não funciona como deveria) ou "feature" (algo que não está lá, mas que pensa que seria bom ter).
* Embora originalmente se pudesse submeter as questões anonimamente, infelizmente isto teve de ser cancelado devido ao ‘spam’. Agora, se desejar criar/editar bilhetes, terá de criar uma conta. Será então, por predefinição, notificado quando alguém acrescentar notas à questão. Em muitos casos, a pessoa que irá tratar do erro necessitará de mais informações da sua parte.
* Although originally you could submit issues anonymously, unfortunately this had to be cancelled due to spam. Now if you would like to create/edit tickets you will have to create an account. You will then by default be notified when someone adds notes to the issue. In many cases, the person who will handle the bug will need more information from you.
* Ao reportar um erro, o ponto mais importante é permitir que os desenvolvedores o reproduzam. Certifique-se de incluir os passos exatos necessários para que o erro aconteça, para que outra pessoa possa fazer o mesmo e ver o erro acontecer também na sua máquina. Se o desenvolvedor não conseguir visualizar o erro, também não poderá solucioná-lo.
* When reporting a bug, the most important point is to allow developers to reproduce it. Be sure to include the exact steps needed to make the bug happen, so another person can do the same and see the bug happen on his machine too. If the developer cannot see the bug, he cannot solve it either.
* Inclua também informação que possa ajudar os desenvolvedores a situar o problema, como o sistema operacional em que executa o FreeCAD, a versão exata do FreeCAD e as bibliotecas relevantes. Por favor, publique todos os dados usando o botão "Copiar para Área de Transferência" na Ajuda(menu) → sobre o diálogo do FreeCAD, e faça-o a partir da bancada de trabalho Part ou PartDesign.
* Also include information that can help developers to situate the problem, like the operating system you are running FreeCAD on, the exact version of FreeCAD and the relevant libraries. Please post all the data by using the "copy to clip board" button in the Help (menu) → about FreeCAD dialogue, and do this from the Part or PartDesign workbench.
* No matter how sure you are that you have found a bug, please always discuss bugs first in the [http://forum.freecadweb.org/viewforum.php?f=3 Help forum].
* Não importa o quão certo está de que encontrou um erro, por favor discuta sempre os erros primeiro no [http://forum.freecadweb.org/viewforum.php?f=3 fórum (Help on using FreeCAD)].
* Before submitting a feature request, always discuss it with other users first on the [http://forum.freecadweb.org/viewforum.php?f=8 Open discussion forum], so you might end up with a more solid proposal, with more chances to interest a developer to implement it.
* Antes de submeter um pedido de recurso, discuta-o sempre primeiro com outros usuários no [http://forum.freecadweb.org/viewforum.php?f=8 fórum de discussão aberto (Open discussion)], para que possa acabar com uma proposta mais concreta, com mais opções interessantes para um desenvolvedor implementar.
* Lembre-se que o FreeCAD é desenvolvido por voluntários que utilizam o seu tempo livre para trabalhar nele. Embora todos deem o seu melhor para fazer a melhor aplicação possível, o seu relatório de erro pode ser tratado com menos prioridade, ou cancelado se não tiver informação suficiente, e o seu pedido de recurso pode ser adiado ou mesmo recusado se nenhum desenvolvedor tiver interesse em implementá-lo ou se isso exigir uma quantidade anormal de trabalho.
* Remember that FreeCAD is developed by volunteers who use their free time to work on it. Although everyone tries his best to make the best possible application, your bug report might be treated with low priority, or canceled if you cannot give sufficient information, and your feature request might be postponed or even refused if no developer has interest in implement it or if that would request an unrealistic amount of work.

== Triage bugs ==

There are dozens of bugs reported on [https://github.com/FreeCAD/FreeCAD/issues GitHub] weekly. It takes a lot of time to read them, categorize them, verify if the issue is reproducible, see if some easy actions can be done, or ask the person who posted the issue to provide more information. Helping to triage is easy, just head over the [https://github.com/FreeCAD/FreeCAD/issues GitHub] and start commenting on any issue where you think you might be able to help!

== Projeto artístico ==

Veja a página [[Special:MyLanguage/Artwork|Objetos gráficos]] e [[Special:MyLanguage/Artwork_Guidelines|Diretrizes para trabalhos gráficos]] para orientações sobre a criação de ícones para o FreeCAD.

<div class="mw-translate-fuzzy">
== Programe! ==
</div>


<div class="mw-translate-fuzzy">
== Design artwork ==
Escrever código para o FreeCAD não é difícil e você não precisa de nenhuma permissão para isso. Você pode começar a trabalhar em algo de que precisa agora mesmo e enviá-lo como um ‘patch’ por meio do [http://www.freecadweb.org/tracker rastreador] ou solicitar sua integração a partir de um [https://github.com/FreeCAD 'branch' no git]. Para evitar dores de cabeça, primeiro você precisa aceitar os seguintes pré-requisitos:
* O FreeCAD avança no seu próprio ritmo, e tem uma equipa muito pequena de programadores. Não temos todo o tempo que gostaríamos de gastar no FreeCAD, e nada está previamente planeado. O trabalho é feito quando um desenvolvedor encontra tempo para o fazer e sente que vale a pena. Não mantemos uma lista de afazeres. Cabe a todos encontrar algo que gostariam de fazer, por exemplo, um erro que gostariam de corrigir, ou uma pequena característica que pensam faltar. O [http://www.freecadweb.org/tracker rastreador] também contém alguns tópicos que não são atribuídos a ninguém, e que estão à espera de um voluntário.
* Antes de começar a codificar para o FreeCAD, é necessário estar familiarizado com o seu funcionamento. Parece óbvio, mas se não souber como funciona, não saberá o que tem que fazer internamente, ou como o fazer.
* Quase tudo pode ser feito em Python ou C++. As tarefas internas funcionam quase da mesma forma em ambas as línguas. Aconselhamos a leitura da página [[Special:MyLanguage/Power_users_hub|Documentação para usuários avançados]], mesmo que planeie programar em C++, pois dar-lhe-á uma boa visão geral do funcionamento interno.
* Se pretende trabalhar com C++, certifique-se de consegue compilar o FreeCAD sem problemas.
* Apresente-se a outros desenvolvedores. O FreeCAD é sobretudo um projeto colaborativo, discutimos muitas coisas no fórum antes de serem implementadas, e é melhor discutir as suas ideias e dizer aos outros o que está planejando antes de o fazer realmente. Também temos um [irc://chat.freenode.net/freecad canal IRC] que está sincronizado com o nosso canal [https://gitter.im/FreeCAD/FreeCAD gitter], mas o fórum é o único e único local onde todos os programadores se encontram.
* Desde 2016, o FreeCAD participa do [[Google_Summer_of_Code_2020|Google Summer of Code 2020]]. Não deixe de conferir nossas ideias aí se tiver interesse em participar da próxima edição.
</div>


== Create models ==
See the [[Artwork|Artwork]] and [[Artwork_Guidelines|Artwork Guidelines]] page for guidelines about designing icons for FreeCAD.


FreeCAD features a [https://github.com/FreeCAD/FreeCAD-library Models library] that is free and open to everyone. Why not add some useful parts there, that could be reused by others? Be sure to create models yourself from scratch, to keep the library 100% free of possibly copyrighted or non-free components.
== Program! ==


Writing code for FreeCAD is not hard, and you don't need any permission, you can start right now to work on something you want, then submit a patch on the [http://www.freecadweb.org/tracker tracker] or request a merge from a [https://github.com/FreeCAD git branch]. To avoid headaches you should meet the following prerequisites first:
* FreeCAD goes at its own pace and has a very small team of developers. We have not as much time as we would like to dedicate to FreeCAD, and things are not planned ahead; they are done when some developer sees it fit and when he finds time to do it. So we don't maintain a list of tasks to be done. It is up to you to find something you would like to do, for example, a defect you would like to correct, or a small feature you think is missing. The [http://www.freecadweb.org/tracker tracker] also contains some items that are not yet assigned to anybody.
* Before you start to code for FreeCAD, you must know well how FreeCAD works. This seems obvious, but if you don't know how it is supposed to work you won't know what to do internally or how to do it.
* Almost everything can be done either in Python or C++. The internals work almost the same in both languages. We suggest you read through the [[Power_users_hub|Power users hub]] pages, even if you're going to code in C++ since it will give you a good overview of the internals.
* If you are going to work in C++, make sure you can compile FreeCAD without problems first.
* Present yourself to other developers. FreeCAD is before anything a social project, we discuss a lot of things on the [http://forum.freecadweb.org forum] before implementing it, and it's always best to discuss your ideas and tell people what you are planning to do before actually doing it. We also have an [irc://chat.freenode.net/freecad IRC channel] which is synchronized with our [https://gitter.im/FreeCAD/FreeCAD gitter] channel, but the forum is the one and only place where you can meet all the developers.
* Since 2016, FreeCAD also participates in the [[Google_Summer_of_Code_2020|Google Summer of Code 2020]]. Be sure to check our ideas there if you are interested in participating in the next edition.


{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 20:09, 24 September 2022

Introdução

Se gosta do FreeCAD e gostaria de ajudar no seu desenvolvimento, para além de doações, há muitas outras coisas que pode fazer, mesmo que não sendo um programador.

Although FreeCAD doesn't need money to be developed, donations can help the project to grow further and faster. The Donate page lists all the options you have to donate money to the project.

Trabalhe na documentação

Ajude-nos a construir, corrigir e ampliar esta documentação. Corrigir erros, estender ou corrigir páginas que não estejam claras, criar novas páginas se faltar um tópico, etc. Contribuir para o wiki do FreeCAD é fácil, em PaginasWiki você pode encontrar as diretrizes gerais e a ajuda necessária para começar. Para editar o wiki, você precisará de uma conta wiki com permissões de "Editor" (o wiki é protegido contra gravação para evitar ‘spam’). Pode solicitar uma conta fórum ou no IRC. Note que o canal do IRC pode não ser tão responsivo como o fórum. O fórum oficial do FreeCAD deve ser o local principal para fazer perguntas e iniciar discussões, pois ajudará a preservar a experiência e o conhecimento da comunidade.

Algumas áreas indicadas para iniciar o trabalho:

  • A página :Categoria:Referência de Comando lista e documenta todos os comandos do FreeCAD. A maioria deles contém pouca ou nenhuma informação. Por favor, consulte PaginasWiki para bons exemplos de como devem ser as páginas de documentação de comandos.
  • A seção Tutoriais precisa de exemplos sobre como utilizar as bancadas de trabalho. Se desenvolveu algo interessante com o FreeCAD, porque não documentar como o fez para a posteridade?
  • Existem entradas pendentes no rastreador de erros marcadas como "documentation" use com amor.

Partilhe o seu conhecimento do FreeCAD

A comunidade de usuários em torno do FreeCAD ainda é pequena, mas já inclui vários usuários avançados que fazem um trabalho muito importante para mostrar aos recém-chegados como utilizar o ‘software’. Se começar a sentir-se confortável com o FreeCAD, os seus conhecimentos poderão ser muito valiosos para outros, e poderá contribuir com recursos importantes como, por exemplo:

  • Mostrando o trabalho que fez com o FreeCAD no fórum 'Users Showcase forum'. Pode colocar capturas de tela e melhor ainda se anexar os arquivos do FreeCAD, para que outras pessoas possam examiná-lo e compreender como foi feito.
  • Gravar vídeos mostrando como fez algo interessante no FreeCAD. Estes vídeos fazem normalmente um excelente trabalho mostrando novas funcionalidades.
  • Escrever tutoriais descrevendo ou ensinando algo interessante. Pode escrever tutoriais no seu próprio "blog", diretamente no nosso wiki, ou mesmo no fórum.
  • Publique na rede social de código aberto Mastodon(e siga o FreeCAD lá) ou na comunidade do Facebook.
  • Veja os últimos posts FreeCAD no Reddit, 3dprinting.stackexchange, StackOverflow... Tente responder e participe das discussões partilhando a sua experiência e informação.
  • Participar do canal IRC FreeCAD ou outras salas de conversa.

Traduza o FreeCAD

Localize o FreeCAD para a sua língua. Todas as cadeias de texto da interface do FreeCAD podem ser facilmente traduzidas para outras línguas. Tudo o que precisamos é de alguém que saiba outras línguas e esteja disposto a ajudar! Todas as traduções são feitas online em Crowdin.

Para mais detalhes sobre a tradução, consulte Localização.

Traduza a documentação

Traduzir é fácil, o wiki FreeCAD suporta um "plugin" de tradução que lhe permite traduzir a página base em inglês para outras línguas.

Para detalhes sobre tradução, consulte Localização#Traduzindo o wiki do FreeCAD.

Por favor, certifique-se de que está familiarizado com os fundamentos de marcação wiki; ver Ajuda:Editando como referência.

Depois dirija-se a PáginasWiki para se familiarizar com o estilo utilizado neste wiki, particularmente quando se trata de modelos.

Ajudar os outros a conhecer o FreeCAD

  • Fale sobre o FreeCAD a outras pessoas que possam ter interesse.
  • Se encontrar usos interessantes para o FreeCAD, documente-os, usando capturas de tela como exemplo. O FreeCAD é bastante jovem, e muitas pessoas não imaginam o que se pode fazer com ele. Se já é um fã do FreeCAD, certamente sabe algo legal que o FreeCAD pode fazer. Ajude-nos a mostrar isso a outros!
  • De uma passada no fórum e ajude os recém-chegados a resolver questões básicas.
  • Escreva tutoriais, grave vídeos, etc., mostrando o que se pode fazer com o FreeCAD.
  • Contribuir com arquivos, desenhos, etc. Ainda faltam bons arquivos de exemplo do que pode ser feito com o FreeCAD.
  • Ajuda para promover o FreeCAD no GitHub dando "Estrela" e "Observando" o repositório FreeCAD

Reportar falhas e solicitar funcionalidades interessantes

Embora o local para relatar erros confirmados e sugerir novas funcionalidades seja eventualmente o rastreador de erros do FreeCAD, por favor, publique sempre primeiro os relatórios de erros e pedidos de funcionalidades no fórum. De modo a poupar tempo aos programadores (triagem e tratamento de erros difíceis de compreender podem ser muito demorados), e evitar frustrações porque o seu problema não foi tratado da forma que gostaria, por favor leia o seguinte:

  • Erros e pedidos de funcionalidades são tratados no mesmo rastreador. Basta marcar o seu problema como "bug" (algo que não funciona como deveria) ou "feature" (algo que não está lá, mas que pensa que seria bom ter).
  • Embora originalmente se pudesse submeter as questões anonimamente, infelizmente isto teve de ser cancelado devido ao ‘spam’. Agora, se desejar criar/editar bilhetes, terá de criar uma conta. Será então, por predefinição, notificado quando alguém acrescentar notas à questão. Em muitos casos, a pessoa que irá tratar do erro necessitará de mais informações da sua parte.
  • Ao reportar um erro, o ponto mais importante é permitir que os desenvolvedores o reproduzam. Certifique-se de incluir os passos exatos necessários para que o erro aconteça, para que outra pessoa possa fazer o mesmo e ver o erro acontecer também na sua máquina. Se o desenvolvedor não conseguir visualizar o erro, também não poderá solucioná-lo.
  • Inclua também informação que possa ajudar os desenvolvedores a situar o problema, como o sistema operacional em que executa o FreeCAD, a versão exata do FreeCAD e as bibliotecas relevantes. Por favor, publique todos os dados usando o botão "Copiar para Área de Transferência" na Ajuda(menu) → sobre o diálogo do FreeCAD, e faça-o a partir da bancada de trabalho Part ou PartDesign.
  • Não importa o quão certo está de que encontrou um erro, por favor discuta sempre os erros primeiro no fórum (Help on using FreeCAD).
  • Antes de submeter um pedido de recurso, discuta-o sempre primeiro com outros usuários no fórum de discussão aberto (Open discussion), para que possa acabar com uma proposta mais concreta, com mais opções interessantes para um desenvolvedor implementar.
  • Lembre-se que o FreeCAD é desenvolvido por voluntários que utilizam o seu tempo livre para trabalhar nele. Embora todos deem o seu melhor para fazer a melhor aplicação possível, o seu relatório de erro pode ser tratado com menos prioridade, ou cancelado se não tiver informação suficiente, e o seu pedido de recurso pode ser adiado ou mesmo recusado se nenhum desenvolvedor tiver interesse em implementá-lo ou se isso exigir uma quantidade anormal de trabalho.

Triage bugs

There are dozens of bugs reported on GitHub weekly. It takes a lot of time to read them, categorize them, verify if the issue is reproducible, see if some easy actions can be done, or ask the person who posted the issue to provide more information. Helping to triage is easy, just head over the GitHub and start commenting on any issue where you think you might be able to help!

Projeto artístico

Veja a página Objetos gráficos e Diretrizes para trabalhos gráficos para orientações sobre a criação de ícones para o FreeCAD.

Programe!

Escrever código para o FreeCAD não é difícil e você não precisa de nenhuma permissão para isso. Você pode começar a trabalhar em algo de que precisa agora mesmo e enviá-lo como um ‘patch’ por meio do rastreador ou solicitar sua integração a partir de um 'branch' no git. Para evitar dores de cabeça, primeiro você precisa aceitar os seguintes pré-requisitos:

  • O FreeCAD avança no seu próprio ritmo, e tem uma equipa muito pequena de programadores. Não temos todo o tempo que gostaríamos de gastar no FreeCAD, e nada está previamente planeado. O trabalho é feito quando um desenvolvedor encontra tempo para o fazer e sente que vale a pena. Não mantemos uma lista de afazeres. Cabe a todos encontrar algo que gostariam de fazer, por exemplo, um erro que gostariam de corrigir, ou uma pequena característica que pensam faltar. O rastreador também contém alguns tópicos que não são atribuídos a ninguém, e que estão à espera de um voluntário.
  • Antes de começar a codificar para o FreeCAD, é necessário estar familiarizado com o seu funcionamento. Parece óbvio, mas se não souber como funciona, não saberá o que tem que fazer internamente, ou como o fazer.
  • Quase tudo pode ser feito em Python ou C++. As tarefas internas funcionam quase da mesma forma em ambas as línguas. Aconselhamos a leitura da página Documentação para usuários avançados, mesmo que planeie programar em C++, pois dar-lhe-á uma boa visão geral do funcionamento interno.
  • Se pretende trabalhar com C++, certifique-se de consegue compilar o FreeCAD sem problemas.
  • Apresente-se a outros desenvolvedores. O FreeCAD é sobretudo um projeto colaborativo, discutimos muitas coisas no fórum antes de serem implementadas, e é melhor discutir as suas ideias e dizer aos outros o que está planejando antes de o fazer realmente. Também temos um canal IRC que está sincronizado com o nosso canal gitter, mas o fórum é o único e único local onde todos os programadores se encontram.
  • Desde 2016, o FreeCAD participa do Google Summer of Code 2020. Não deixe de conferir nossas ideias aí se tiver interesse em participar da próxima edição.

Create models

FreeCAD features a Models library that is free and open to everyone. Why not add some useful parts there, that could be reused by others? Be sure to create models yourself from scratch, to keep the library 100% free of possibly copyrighted or non-free components.