[PATCH 0/1] FAQ for common user questions

Git is an enormously flexible and power piece of software, but many people find it confusing and hard to use. Over the time I've been contributing, I've noticed a lot of the same questions keep coming up over and over. Some of these questions are well answered by existing documentation, but people have trouble finding it. Others are not answered, and still others are questions about integrating with common tools and hosting platforms.

To help people find and discover this documentation, let's provide a FAQ that covers common issues. A lot of these issues are things I've seen asked on Stack Overflow or elsewhere and we'd be doing everyone a service if we included some stock answers in one place in our documentation.

The FAQ is designed to be conversational, approachable, and geared towards a competent novice user. However, it also addresses questions that I've seen from technically advanced colleagues. I've tried to make it address common questions about integrations with other tools, such as CI systems and hosting platforms, without mentioning any specific tool by name. This keeps us neutral on particular tools, but recognizes that these tools are a common part of people's development experiences.

I definitely think we'll add more questions as we go along, but this seems like a reasonable start for now. I'd love feedback about the phrasing of questions or answers, anything I've missed, and anything that might be technically inaccurate, especially about Windows.

brian m. carlson (1):
  docs: add a FAQ

 Documentation/Makefile   |   1 +
 Documentation/gitfaq.txt | 330 +++++++++++++++++++++++++++++++++++++++
 2 files changed, 331 insertions(+)
 create mode 100644 Documentation/gitfaq.txt