Produzindo Software Open Source

Como executar um projeto de Software Livre com Sucesso

Karl Fogel

(Autor) 

Daniel Ribeiro Matos

(Tradutor) 

Eder Luis Jorge

(Tradutor) 

Rafael Abrahão Santos

(Tradutor) 

Dedicatória

Este livro é dedicado a dois queridos amigos, sem os quais ele não seria possível: Karen Underhill e Jim Blandy.

Índice

Prefácio
Por quê escrever este livro?
Quem deve ler este livro?
Fontes
Agradecimentos
Aviso
1. Introdução
História
O Crescimento do Software Proprietário e do Software Livre
Resistência consciente
Resistência Acidental (Accidental resistance)
"Livre" Versus "Código Aberto"
A Situação Atual
2. Primeiros Passos
Começando-se com o que tem
Escolha um bom nome
Tenha uma declaração de missão clara
Declare que o projeto é livre
Lista de Funcionalidades e Requerimentos
Status de desenvolvimento
Downloads
Acesso ao Controle de Versão e ao Bug Tracker
Canais de Comunicações
Guia dos Desenvolvedores
Documentação
Disponibilidade da documentação
Documentação do desenvolvedor
Exemplos de Saídas e Capturas de Telas
Hospedagem enlatada
Escolhendo a Licença e Aplicando-a
As Licenças "Faça o Que Quiser"
A GPL
Como Aplicar a Licença ao Seu Software
Ajustando o Tom
Evite Discussões fechadas
Corte o Mal pela Raiz
Pratique uma Revisão de Código Visível
Ao Abrir um Projeto Anteriormente Fechado, Seja Sensível a Magnitude da Mudança
Anunciando
3. Infra-estrutura técnica
O Quê Um Projeto Precisa
Listas de E-mail
Prevenção de Spam
Filtrando os envios
Camuflando endereços em arquivos da lista
Gerenciamento de Identificação e de Cabeçalho
O Longo Debate do Responder a
Duas fantasias
Arquivamento
Software
Controle de Versão
Vocabulário do Controle de Versão
Choosing a Version Control System
Using the Version Control System
Version everything
Browsability
Commit emails
Use branches to avoid bottlenecks
Singularidade de Informação
Autorização
Bug Tracker
Interação com listas de E-mail
Pré-filtrando o Bug Tracker
IRC / Real-Time Chat Systems (sistemas de bate-papo em tempo real)
Bots (robôs)
Arquivando o IRC
Wikis
Web Site
Canned Hosting
Choosing a canned hosting site
Anonymity and involvement
4. Social and Political Infrastructure
Benevolent Dictators
Who Can Be a Good Benevolent Dictator?
Consensus-based Democracy
Version Control Means You Can Relax
When Consensus Cannot Be Reached, Vote
When To Vote
Who Votes?
Polls Versus Votes
Vetoes
Writing It All Down
5. Money
Types of Involvement
Hire for the Long Term
Appear as Many, Not as One
Be Open About Your Motivations
Money Can't Buy You Love
Contracting
Review and Acceptance of Changes
Case study: the CVS password-authentication protocol
Funding Non-Programming Activities
Quality Assurance (i.e., Professional Testing)
Legal Advice and Protection
Documentation and Usability
Providing Hosting/Bandwidth
Marketing
Remember That You Are Being Watched
Don't Bash Competing Open Source Products
6. Communications
You Are What You Write
Structure and Formatting
Content
Tone
Recognizing Rudeness
Face
Avoiding Common Pitfalls
Don't Post Without a Purpose
Productive vs Unproductive Threads
The Softer the Topic, the Longer the Debate
Avoid Holy Wars
The "Noisy Minority" Effect
Difficult People
Handling Difficult People
Case study
Handling Growth
Conspicuous Use of Archives
Treat all resources like archives
Codifying Tradition
No Conversations in the Bug Tracker
Publicity
Announcing Security Vulnerabilities
Receive the report
Develop the fix quietly
CAN/CVE numbers
Pre-notification
Distribute the fix publicly
7. Packaging, Releasing, and Daily Development
Release Numbering
Release Number Components
The Simple Strategy
The Even/Odd Strategy
Release Branches
Mechanics of Release Branches
Stabilizing a Release
Dictatorship by Release Owner
Change Voting
Managing collaborative release stabilization
Release manager
Packaging
Format
Name and Layout
To capitalize or not to capitalize
Pre-releases
Compilation and Installation
Binary Packages
Testing and Releasing
Candidate Releases
Announcing Releases
Maintaining Multiple Release Lines
Security Releases
Releases and Daily Development
Planning Releases
8. Managing Volunteers
Getting the Most Out of Volunteers
Delegation
Distinguish clearly between inquiry and assignment
Follow up after you delegate
Notice what people are interested in
Praise and Criticism
Prevent Territoriality
The Automation Ratio
Automated testing
Treat Every User as a Potential Volunteer
Share Management Tasks as Well as Technical Tasks
Patch Manager
Translation Manager
Documentation Manager
Issue Manager
FAQ Manager
Transitions
Committers
Choosing Committers
Revoking Commit Access
Partial Commit Access
Dormant Committers
Avoid Mystery
Credit
Forks
Handling a Fork
Initiating a Fork
9. Licenses, Copyrights, and Patents
Terminology
Aspects of Licenses
The GPL and License Compatibility
Choosing a License
The MIT / X Window System License
The GNU General Public License
Is the GPL free or not free?
What About The BSD License?
Copyright Assignment and Ownership
Doing Nothing
Contributor License Agreements
Transfer of Copyright
Dual Licensing Schemes
Patents
Further Resources
A. Sistemas de Controle de Versão Livres
B. Free Bug Trackers
C. Why Should I Care What Color the Bikeshed Is?
D. Example Instructions for Reporting Bugs
E. Copyright