As I wrote previously here, I am thinking about returning to doing the
Git User's Survey this year.

  Message-ID: <577e6f32.7020...@gmail.com>


In this email I'd like to propose the revised list of questions (and
answers) for Git User's Survey 2016, following comments to the previous

  Message-ID: <91a2ffbe-a73b-fbb9-96da-9aea4d439...@gmail.com>


Below is my second proposal; old comments are prefixed with "jn> ", new ones
are prefixed with "JN> ".

#### About you

jn> This section gives us a bit of demographic information about survey
jn> responders.  Is it useful?  Should we keep it?

01. What country do you live in? (Country of residence, in English)
    (free-form single line)

jn> Survs.com do not offer list of countries as a pre-defined drop-down
jn> list (select, with search), and it looks like it is not as easy as
jn> I thought (though I could push responsibility to Locale::Country ;-):
jn>   https://en.wikipedia.org/wiki/List_of_sovereign_states
jn> This question originally read "What country are you from?"
jn> which might be thought as country of birth... which country
jn> may not exist any longer, like East Germany.

02. How old are you (in years)?
    (single number, or single choice)

jn> Perhaps a selection of age ranges would be better (if less precise).
jn> We could follow the example of StackOverflow Survey here, see below.
JN> Though oldest / youngest info could be interesting...

  * <20
  *  20-24
  *  25-29
  *  30-34
  *  35-39
  *  40-49
  *  50-59
  * >60

03. Your gender
    (single choice)

  *  Man
  *  Woman
  *  Other
  *  Prefer to not disclose

jn> This would be new question, to check if we good good diversity
jn> among survey responders (and not skewed in particular direction).
jn> Though I am not sure if it is a good idea...

04. How would you describe your occupation / role as Git user?
    (multiple choice with other, limit to 3 selections (?))

  + Developer
  + Programmer
  + Engineer
  + Analyst
  + Manager / Leader
  + Maintainer / Reviewer / Sub-maintainer
  + DevOps
  + Administrator
  + Designer
  + Artist / Writer
  + Tester / QA
  + Expert
  + Student
  + Researcher
  + Teacher
  + Other, please specify

jn> This is a new question, based somewhat on "Developer Occupations"
jn> and "Programmers, Engineers, and Developers" questions in 
jn> StackOverflow Survey.  It is here to find out if different
jn> occupation leads to different ways of using Git, and if there
jn> is some occupation that is not well served by Git.
jn> The list of "occupations" is preliminary, and I would like to
jn> ask for your thought about possible answers.

05. Have you ever contributed to Git project (code, documentation, i18n, etc.)?
    (single choice)

  * Yes
  * No
  * Maybe
  # Tried to             <--- new answer

jn> This is here to correlate other responses with Git developers.
jn> In 2012 it was called "Does Git include code or documentation by you?
jn> (Are you a Git developer?)".  I think this way of stating it is better;
jn> if it is here to stay - the number of active and past developers is
jn> not very large.  On the other hand it can be used to detect if we
jn> have a bias due to the way survey is announced.

JN> This would also serve as a reminder that Git is an open-source
JN> project (and free software), and anyone can contribute to it.
JN> Should there be a similar question about doing review?

06. What's stopping you from contributing to Git?
    What was hardest / most difficult when contribution to Git?
    (free-text essay question)

JN> This was the question proposed by Duy Nguyen in "Working with
JN> public-inbox.org" thread (well, the first part of it):

jn> NOTE: earlier surveys have had two additional questions that were
jn> since removed (to make survey shorter, among others).  Those were:
jn>  - What is your preferred [non-programming] language?
jn>  - Which programming languages / technologies you are proficient with?
jn> Well, the latter was only about programming languages, originally.
JN> And it would be possibly added, of in later section ("Other tools").

#### Getting started with Git

jn> This is probably not the best name for this section of questions.
JN> Can anyone think of a better one?

07. Have you found Git easy to learn?
    (single choice)

  * Very easy
  * Easy
  * Reasonably easy
  * Hard
  * Very hard

08. Have you found Git easy to use?
    (single choice)

  * Very easy
  * Easy
  * Reasonably easy
  * Hard
  * Very hard

jn> Those two questions, considered alone, doesn't tell us much.  If one
jn> uses git, then usually one does not think it is too hard to use
jn> (unless forced to use git by external circumstances, like project
jn> he/she works on using git).  On the other hand those two questions
jn> together give us some measure of Git's learning curve, telling us
jn> if people consider git easy to use but hard to learn, or vice versa ;-)
jn> This question was present from the beginning of Git User's Survey,
jn> so it can be used to compare with historical surveys, and see
jn> Git evolution in motion (hopefully in good direction, that is getting
jn> easier to learn and use).

09. Which Git version(s) are you using?
   (multiple choice, with other)

 + pre 2.0
 + 2.0.x to 2.5.x
 + 2.6.x
 + 2.7.x
 + 2.8.x
 + 2.9.x or newer

 + 2.10.x-rcN version (release candidate)
 + minor (maintenance) release 1.x.y.z
 + 'master' branch of official git repository
 + 'next' branch of official git repository
 + version from msysGit / Git for Windows fork repository
 + alternate Git implementation (JGit and similar)

 + other, please specify

jn> I don't know if it is a good range.  One thing that might be good
jn> to know is people using outdated Git, perhaps because it is version
jn> bundled with GUI tool (e.g. using last msysGit instead of Git for
jn> Windows, that is 1.9.x at latest).
jn> If we want connection with last survey, from 2012, we would
jn> need to go back down to 1.7.x or earlier version...

10. On which operating system(s) do you use Git?
    (multiple choice, with other)

 + GNU/Linux
 + MS Windows
 + macOS
 + *BSD (FreeBSD, OpenBSD, NetBSD, etc.)
 + Android
 + iOS
 + other Unix
 + other, please specify

jn> This question was a part of previous surveys, but it was asked
jn> a bit later.  This year I skipped asking about Cygwin vs native
jn> Git for Windows.  Note that I am not sure if Android and iOS,
jn> added just now, should be present here.

11. Rate your own proficiency with Git
    (single choice, rating)

 1. novice
 2. casual, needs advice
 3. everyday use
 4. can offer advice
 5. know it very well

You can think of it as 1-5 numerical grade of your proficiency in Git.

jn> This question tell us penetration of announcements of the survey;
jn> did we get to all users, or only to git gurus?  It is also useful
jn> for correlating with other responses, for example to get to know
jn> which Git features are used by novices, and which by gurus.
jn> Note that the answers are rather here to stay because of
jn> "backwards compatibility", that is to be able to easy compare
jn> with earlier surveys.

#### How do you use Git

12. I use Git for (check all that apply):
    (multiple choice, with other)

Note that those choices are neither orthogonal nor exclusive.  One
might want to check multiple answers even for a single repository.

jn> Answers to this question probe different direction.
jn> We might want to split this question... but on the other hand
jn> I think we'd rather reduce the number of questions in the survey.

 + work and work-related projects
 + unpaid projects
JN> This is one possible point of split, work vs unpaid.  Are there
JN> other possibilities in this dimension?

 + closed-source projects
 + OSS development, public domain, and published & unlicensed
 + private (unpublished), in house projects

jn> It was "proprietary projects" instead of "closed-source projects"
jn> in previous version(s) of Git User's Survey (and it does not
JN> belong in this dimension).  This is another possible point of
JN> splitting into a separate question.

 + code (programming) and its documentation
 + data, documents, static assets (without code)

JN> That is another dimension, another possible split into a separate
JN> question: what types of content is stored in git repositories.
JN> Are there any other types of data?

 + sharing data or synchronization
 + managing configuration files
 + backup
 + frontend / fat-client to other SCM (e.g. git-svn, git-p4)

jn> I'm not sure if the last answer should not be moved to
jn> question about other version control systems

 + other, please specify

13. How do/did you obtain Git (install and/or upgrade)?
    (multiple choice, with other)

jn> Perhaps this question should be moved to previous section.
JN> Or to a separate section, "Getting Git", or something like
JN> that.

Note that this question is multiple choices question because one can
install Git in different ways on different machines or on different
operating systems.

 + binary package
 + source package or script (automatic compiling)
 + source tarball/archive (extract, make, make install)
 + pull from repository, and compiled
 # bundled with GUI or other kind of tool
 + preinstalled / sysadmin job

 + other - please specify (if none of the above apply)

jn> The "bundled" answer is new.  I guess that most people would
jn> not check if GUI brought it own Git (sometimes very outdated;
jn> SourceTree for Windows bundled git 1.9.7 (sic!)) and is using
jn> it instead of system- or user-installed Git.
jn> Note for example that Eclipse brings JGit, implementation
jn> of Git in Java, and would be covered by "bundled" answer...
JN> The question about Git version and operating system could be
JN> brought together with this question.

14. How often you upgrade Git?
    (multiple choice or single choice?)

 # use 'master' or 'next' version, and/or pre-release
 * as soon as new version is released
 * when there is new binary package / distribution package
 * when updating distribution / system
 * around every month, or more often
 * around every 6 months or more often
 # update from time to time, cannot say how often
 * I use what is installed on system

JN> This question was added (well, considered to be added) at the
JN> request / suggestion by Andrew Ardill
JN>   Message-ID: 

jn> NOTE: I think we can skip
jn>   What Git interfaces, implementations and frontends do you use?
jn> question.  What do you think?

15. What kind of Git tools do you use?
    (multiple choice, with other)

 + editor/IDE VC integration (e.g. EGit (for Eclipse), TextMate bundle, magit 
(for GNU Emacs))
 + filemanager / shell extension (e.g. git-cheetah, TortoiseGit, Git Extension)
 + filesystem interface (e.g. gitfs, figfs)
 + graphical history viewer/browser (e.g. gitk; might be a part of GUI tool)
 + graphical commit tool (e.g. git-gui; might be a part of GUI tool)
 + graphical diff and/or merge tool (e.g. Kompare, Meld; might be a part of GUI 
 + graphical blame or pickaxe tool (e.g. 'git gui blame'; might be a part of 
editor plugin)
 + tool to manage git repositories (e.g. Gitolite)
 + git-instaweb, or self-hosted web interface (e.g. gitweb, cgit)
 + self-hosted project hosting solution (e.g. GitLab, GitHub FI, GitPrep, 
 + self-hosted code review or audit system (e.g. Gerrit, Differential)
 + patch or patch series management interface (e.g. StGit, Guilt, git-series)
 + command line tab-completion, or equivalent (e.g. git-completion.sh)
 + shell prompt, or widget, desklet, etc. (e.g. git-prompt / __git_ps1(), 
 + git aware pager, or syntax highlighter (e.g. tig, diff-highlight)

 # large files handling (e.g. git-LFS, git-annex)
 # handling subprojects or multiple repositories (e.g. git-stree, repo, 

 + credentials helper, or askpass wrapper (e.g. wincred, winstore, cache)
 + remote helper to store repository (e.g. FTP, Amazon S3, Dropbox)
 + remote helper to interact with foreign repositories (e.g. git-hg)

 + my own scripts (for daily use)
 + my own scripts (for special tasks)

 + other, please specify

jn> Does this list cover all kind of tools that one might be using,
jn> or is some category missing from the above list (slightly modified
jn> and extended compared to previous surveys)?

JN> Answers about large file support and subproject / dependency handling
JN> are new in this revision of the proposal.

16. List Git tools that you are using (comma separated, or one per line)
16. List git tools that you use (optional)

jn> Open ended questions are often a pain to analyze, but I don't think
jn> this one would be a problem.  Instead of free-form text field we
jn> could provide a list of most common GUIs and other tools... but I am
jn> not sure what they are, and we are risking skewing results.  On the
jn> other hand free-form might mean people forgetting about tool they use,
jn> or used in the past; it is also a bit more work, to write and not
jn> only to select.

17. How often do you use Git command line (and other command line tools)?
    (single-choice, rating-like)

  1. never
  2. rarely
  3. often
  4. only (always)

jn> This is a new question, replacing somewhat "What Git interfaces,
jn> implementations and frontends do you use?".  I'm not quite sure if
jn> it is a question worth to have.  Though it would be good to verify
JN> the assumption that people have access to command-line tools.
JN> And perhaps correlate use of CLI with use of advanced features.

18. Which git hosting site(s) do you use for your project(s)?
    Please check only hosting sites where you publish/push to (with git)
    (multiple choice, with other)

jn> I think it should be limited to *main* hosting sites; there is
jn> always the "other, please specify" option

  + GitHub
  + Bitbucket
  + GitLab

  + SourceForge
  + Savannah or Gna!
  + CodePlex

  + Assembla
  + Beanstalk
  + CloudForge (formetly Codesion)
  + Codebase
  + Deveo
  + Unfuddle

JN> The above section is new... and would allow us to ask for announcement
JN> about Git User's Survey 2016 on those sites.

  + git hosting site for related projects (e.g. OLPC, freedesktop.org)
  + company internal / self-hosted

  + other, please specify

jn> Gitorious was acquired/changed into GitLab, Google Code is in archive
jn> mode, BerliOS is no longer.  CodePlex is new; many hosting sites that
jn> were present are missing, but could be added: Assembla, Beanstalk,
jn> CloudForge (formerly Codesion), Codebase, Deveo, Unfuddle, perhaps
jn> even Alioth (Debian), Fedora Hosted, Launchpad (Ubuntu)
jn> "Company internal" and "self-hosted" got concatenated into one answer.
jn> This question could be moved to the next section.

19. If you, your project or your company self-hosts Git repositories,
    what Git repository management tools do they use?
    (multiple choice, assuming mostly single selected, with other)

JN> This was a suggestion by David Bainbridge: "This is not directly
JN> about Git of course but seeing the extent to which these are used,
JN> and the proportion of users using them might be useful."

  + Gitolite
  + Gitosis (DEPRECATED)

  + Gerrit

  + Kallithea
  + Rhodecode
  + Phabricator

  + Bitbucket Server (Atlassian)
  + GitHub Enterprise
  + GitLab Community Edition (OSS)
  + GitLab Enterprise Edition
  + Deveo On-Premises

  + GitPrep
  + Girocco (repo.or.cz)

  + don't use self-hosted / on-premises

  + other, please specify

JN> This was somewhat present in previous version of survey, namely
JN> there is question about *types* of tools (with git repository
JN> management, git hosting tools and code review tools included),
JN> and there is free-form question asking to enumerate tools one uses.
JN> Though I guess people would forget to write about them, if not
JN> asked explicitly.

#### Git workflows, or
#### Interacting with other repositories

20. How do you fetch/get changes from upstream repositories
    and/or other developers?
    (multiple choice, with other)

 + git protocol        (e.g. git://git.example.com/repo.git)
 + ssh                 (e.g. ssh+git://git.example.com/repo.git,
 + http(s              (e.g. http://git.example.com/repo.git)
 + rsync (DEPRECATED)  (e.g. rsync://git.example.com/repo.git)
 + filesystem          (e.g. /path/to/repo.git, file:///path/to/repo.git)
 + applying patches    (e.g. git-am from emails, or other source)
 + via git-bundle
 + foreign SCM (fat-client or remote helper, e.g. git-svn, git-p4, gitifyhg)

 + Other, please specify

jn> Nobody should be using rsync, as it got broken and nobody noticed,
jn> and then removed from Git.  Note that "applying patches" is new,
jn> because question got extended to cover getting changes from other
jn> developers (in maintainer role), not only from upstream repo.
jn> This question is about getting changes into local work repository.

21. How do you publish/propagate your changes?
    (multiple choice, with other)

 + push via SSH
 + push via HTTP / HTTPS
 + push via git protocol (NOT RECOMMENDED)
 + push (unknown)
 + pull request (+ any form of announcement / notification)
 + format-patch + email
 + format-patch + other (e.g. reviewboard, issue tracker or forum)
 + git bundle

 + git-svn (to Subversion repository)
 + git-p4 (to Perforce repository)
 + foreign SCM interface (other than mentioned above)

 + other - please specify

22. How do you integrate changes from others?
    (multiple choice, with other)

 + merge  (includes 'git pull')
 + rebase (includes 'git pull --rebase')
 + reapply (e.g. git-am from patches)
 + git-imerge (third-party tool)

 + git mergetool, or graphical merge tool directly
 + graphical rebase tool

 + other, please specify

jn> This is proposed new question about workflows.

23. What types of branches can be found in your repositories?
    (repositories you use or are contributing to)
    (multiple choice, with other)

 + there is only a single branch
 + development/graduation branches (master/stable, next/devel/unstable etc.)
 + per-release maintenance branches (or release branches)
 + proposed-updates integration testing and WIP publish branch

 + bugfix / hotfix branches (topic branches for bug fixes)
 + release branches (for preparing a new release)
 + other short-lived topic / feature branches

 ? orphan branches (with disconnected history, e.g. gh-pages, todo)

 + other types and uses, please describe

jn> This is new question.  It doesn't ask about use of git-flow, but
jn> is close.  I think all types of branches are covered, isn't it?

24. Which of the following signing features do you use?
    How do you sign your Git repositories?
    (multiple choice)

JN> This is a new question; it somewhat overlaps with the following
JN> question about Git features, but I think it would be nice to have
JN> it separate.

  + digital certificate of origin ("Signed-off-by:")
  + signed tags
  + signed commits
  + signed merges (merging signed tags)
  + signed pushes

JN> Should there be "other, please specify"?  Are there any other ways
JN> of signing repositories?  Would this question be useful?
JN> Could be dropped.

#### How you use Git

25. Which of the following Git features do you use?
    (multiple choice, with other)

 + end-of-line conversion (crlf or eol)
 + custom diff/merge driver
 + textconv
 + other gitattributes (e.g. clean/smudge filter)

 + word diff
 + merge strategy options (e.g. -Xrenormalize)

 + submodules (subprojects)
 + subtree merge (e.g. git-subtree, git-stree)

 + partial (sparse) checkout
 + shallow clone (e.g. "git clone --depth=<n>")

 + multiple worktrees (e.g. git-worktree)

 # searching history for commit message and metadata (e.g. "git log --grep")
 # searching changes in history, pickaxe search ("git log -S" and "git log -G")
 # finding errors in history with bisect (also "git bisect run <script>")

 + tracking code movement with git-blame ("git blame -M" etc.)
 # history of lines ("git log -L")

 + detaching HEAD (e.g. "git checkout --detach", "git checkout <tag>")
 + orphan branches, with disconnected history (gh-pages, todo, man, etc.)

 + alternates mechanism (sharing object database)
 + stash and autostash (also "git stash --keep-index")
 + commit message templates, and/or commit-related hooks
 + interactive commit / per-hunk comitting / partial commit / splitting commits
 + interactive rebase, fixup commits (small scale history editing)
 + git-filter-branch or equivalent, like BFG Repo Cleaner (large history 
 + committing with dirty tree (keeping some changes uncommitted)
 + reflog (including @{1}, @{yesterday}, @{-1} / -, 'git log -g')

 # client-side hooks (e.g. pre-commit)
 # server-side hooks (e.g. post-receive)

 + git-aware shell prompt
 + git aliases, shell aliases for git, or own git scripts

 + one-way interaction with other SCMs (from SCM to git)
 + two-way interaction with other SCMs (from SCM to git, from git to SCM)

 + object overlays (git replace or grafts)
 + object annotation (git notes)

 + Other, please specify

jn> The problem is come up not with exhaustive list of features: there are
jn> too many of them to list.  The problem is coming up with list of
jn> important and used enough often features (and those interesting to
jn> know about).
jn> So: what features should be included in this list?  What features
jn> should be removed from above list of answers?
jn> Should this question be split into parts?  Should we ask how often
jn> those features are used (matrix-form question)?

JN> New features are marked (here and in other places) with '#' as bullet
JN> point in place of '+' (or '*' in other places).  This looks like
JN> longest list of answers for a question...

26. Describe what features would you like to have in Git
    (free form, essay length / textarea)

jn> The Git User's Survey 2012 (last survey) have had also
jn> "17. Which of the following features would you like to see
jn> implemented in git?", with a list of answers.  But as Git development
jn> is not directed by surveys, I'm not sure if it is worth it.
jn> Such free-form question would be a pain to analyze well, but it
jn> could also be a source of a good inspiration.

#### Other version control systems

27. What other version control systems (SCM) do you use beside Git?
   (multiple choice, with other)

Explanation: "using" version control system here means using
it to actively contribute (propose changes or accept proposals),
and not only e.g. using it to download software.

jn> Perhaps we should split it into two questions, one about
jn> centralized version control systems, one about distributed
jn> ones; longer list of answers vs more questions.
jn> Clarification (narrowing of scope) is new.

 + RCS

 + CVS
 + Subversion

 + Perforce
 + ClearCase
 + AccuRev SCM
 + StarTeam
 + Visual SourceSafe
 + Team Foundation Server
 + Visual Studio Team System / ALM
 + Rational Team Concert

 + Bazaar (bzr)
 + Mercurial (hg)
 + Monotone
 + Darcs
 + SVK
 + Fossil
 + Veracity

 + BitKeeper
 + Code Co-op
 + TeamWare
 + Plastic SCM
 + Veracity

 + other, please specify

jn> Is there any *prominent* and important version control system
jn> missing from this list?  Are there systems that are so rare that
jn> they should be removed from the list?

JN> If not for "other, please specify" it could be made into matrix
JN> form, and ask how often one uses other version control systems,
JN> for example
JN>   never used / used in past / rarely / often

28. How does Git compare to other SCM tools that you have used?
    (single choice, rating)

Git is ____ that other version control systems I have used.

 * better
 * equal (comparable)
 * it depends (in some matters better, in some matters worse)
 * worse
 * cannot compare (have not used anything beside Git)

JN> The answers "it depends" and "cannot compare" are new in this
JN> year's survey (well, "cannot compare" could have been answered
JN> as not putting any answer in previous surveys).

#### Other tools

JN> This section was added (well, considered to be added) thanks
JN> to request / suggestion in a comment by Eric Wong in
JN>   Message-ID: <20160820212937.GA20555@starla>
JN> Well, the suggestion was about federated systems only.

> Perhaps there can be a question about use and interest of other
> decentralized/federated systems which could be potential
> collaboration tools or transports for git.
> e.g. ipfs, gpg, tor, diaspora, *coin, tent, xmpp, matrix, ...
> And another about how they use email: webmail, GUI client,
> console client, phone app, none at all.

29. How do you read and answer email (check all that apply)?
    (multiple choice, possibly with other)

 + GUI client (e.g. Outlook, Thunderbird, Evolution, KMail)
 + console client (e.g. pine, alpine, mutt)
 + webmail or web client (e.g. GMail, Hotmail; HyperKitty)
 + phone app (e.g. K-9 Mail, Airmail, CloudMagic)
 + I don't use email at all

30. Which of the decentralized/federated systems do you use
    or are interested in?

JN> Have I missed some interesting and Git-relevant federated system?

 + PGP / GPG
 + Tor
 + diaspora*
 + Bitcoin, Litecoin, Etherium, etc.
 + tent.io
 + XMPP / Jabber
 + Matrix.org
 + pump.io
 + other, please specify

There are a few other questions that we might want to ask if
such section is to be added to the Git User's Survey 2016:

31. Which of IDEs and programmer's editors do you use [with Git]?
    (multiple choice, with other)

JN> Have I missed some popular IDE or programmers editor?

 + Visual Studio
 + Eclipse
 + NetBeans
 + Xcode
 + IntelliJ IDEA / PhpStorm / WebStorm
 + KDevelop
 + Anjuta

 + Sublime Text
 + TextMate
 + Emacs
 + Vim
 + Atom
 + Brackets
 + Geany

 + other IDE or editor, please specify

32. Which of the programming languages are you proficient with?
    (multiple choices, with other)

JN> Based on TIOBE index from August 2016, Language Trends on GitHub
JN> 2015, GitHut (languages in GitHub), Stack Overflow Developer
JN> Survey 2016, and my own preferences; in no particular order

 + C
 + C++
 + C#
 + Java
 + VisualBasic.NET 
 + Objective-C

 + Python
 + Perl
 + PHP
 + JavaScript
 + Ruby
 + shell scripe

 + CSS, LESS, SASS etc.
 + TeX, LaTeX, ConTeXt
 + SQL

 + Go
 + Rust
 + Swift
 + Scala
 + Haskell

 + other, pleasespecify

#### What you think of Git?

33. Overall, how happy are you with Git?
    (single choice, rating)

 * unhappy
 * not so happy
 # neutral
 * happy
 * very happy
 * completely ecstatic

jn> I'm not sure if this question is at all useful.
jn> There is also problem, that the current wording is considered biased
jn> by some, but on the other hand changing wording of answers would make
jn> it impossible to compare it to answers from previous surveys...
jn> Though I have added 'neutral' as an answer.  Perhaps I should add
jn> most negative answer to make rating balanced?  For example ;-)
jn>   # hate Git with a passion of thousands suns

34. In your opinion, which areas in Git needs improvement?
    Please state your preference.

   Columns: don't need / a little / some / much
 + user-interface (UI and UX)
 + core documentation
 # messages, error messages, advices
 + performance
 + more features
 + tools (e.g. GUI)
 + localization (translation) of messages
 # translated documentation (manpages)

jn> Are there any general areas that are missing from this list?
jn> What are they?  (Matrix form cannot have "other, please specify").
jn> Note that "translated documentation" and "messages..." are new.

35. How do you compare the current Git version with the version from one year 
    (single choice)

 * better
 * no changes
 * worse

 * cannot say
 * Git used for less than 1 year

jn> This question is mainly excuse for providing list of main changes
jn> from the year ago, to show off how Git continues improving.
jn> List of new features and other changes taken from RelNotes.

JN> I am considering dropping this question.  It is of questionable
JN> utility; it was more useful (as an announcement of new features)
JN> when there were annual surveys.

The version from approximately one year ago is x.y.z from DD-MM-YYYY
(x.y.v is from DD-MM-YYYY).

Changes since x.y.z include:


#### Documentation. Getting help. ==

36. How useful have you found the following forms of Git documentation?

  Columns: never used / not useful / somewhat / useful
 + help distributed with git (manpages, tutorials, guides, etc.)
 + "Pro Git" book
 + Git Wiki
 + Git Reference site
 + hosting site tutorials and help, etc.
 + 'git' section of StackOverflow Documentation
 + other on-line help
 + printed books (or ebooks)

* help distributed with Git includes their online version:
  - https://git.github.io/htmldocs/git.html
  - https://git-scm.com/docs/
  - https://www.kernel.org/pub/software/scm/git/docs/
* Git Wiki was to be found at http://git.wiki.kernel.org
* Git Reference site can be found at http://gitref.org
* StackOverflow Documentation refers to 
* "Pro Git" can be found at https://git-scm.com/book and https://progit.org
* hosting sites tutorials include
  - https://help.github.com/
  - https://www.atlassian.com/git/
  ? https://www.git-tower.com/learn/git/ebook
* help distributed with git include manpages, manual, tutorials, HOWTO,
  release notes, technical documentation, contrib/examples/

jn> Should we split those answers further, e.g. separating on-line
jn> tutorials and guides, from on-line tips etc.?
jn> This is also educational, showing where one can find documentation;
jn> note that StackOverflow Documentation in yet in Beta.

37. What [channel(s)] do you use to request/get help about Git [(if any)]?
   (multiple choice, with other)

 + git mailing list (git@vger.kernel.org)
 + "Git for Human Beings" Google Group
 + msysGit mailing list / Google Group
 + IRC (#git)
 + IRC (other git/SCM related, e.g. #github)
 + IRC (other than above)
 + request in blog post or on wiki
 + asking git expert/git guru/colleague/friend
 + project mailing list, or IRC, or forum
 + Twitter or other microblogging platform
 + instant messaging (IM) like XMPP/Jabber
 + StackOverflow or other StackExchange site
 + search specific site or whole web (e.g. with Google)

 + find and read book or ebook
 + watch an instructional video or course
 + attend a seminar, webinar or lecture about Git (interactively)

 + N/A (didn't request help about Git)

 + other (please specify)

jn> Are there any main channels of requesting help that I have missed in
jn> the above list of answers?  What are they, and why do you think they
jn> are important enought to warrant inclusion in above list?
jn> Should we ask the opposite: how one provides help (if one does)?

38. Which books about Git have you read and recommend, or plan to read?
    (multiple choice, with other)

jn> New question.  List of answers based partially on the "Books" section
jn> in https://git-scm.com/documentation/external-links , ordered by date
jn> of latest edition to within a year.
jn> Should "plan to read" be included in question, or not?

 + "Pragmatic Version Control Using Git", by Travis Swicegood (2008)
 + "Pragmatic Guide to Git", by Travis Swicegood (2010)
 ? "Version Control by Example", by Eric Sink (2011)
 + "Version Control with Git", by by Jon Loeliger and Matthew McCullough
   (1st ed. 2009, 2nd ed. 2012)
 + "Git: Version Control for Everyone", by Ravishankar Somasundaram
 + "Pro Git", by Scott Chacon and Ben Straub (1st ed. 2009, 2nd ed. 2014)
 + "Git Version Control Cookbook", by Aske Olsson and Rasmus Voss (2014)
 + "Git in Practice", by Mike McQuaid (2014)
 + "Git for Teams", by Emma Hogbin Westby (2015)
 + "Git Essentials", by Ferdinando Santacroce (2015)
 + "Mastering Git", by Jakub Narębski (2016)

jn> What *good* books should be added here?  I'd rather add only those books
jn> which have a paper version, and not be ebook-only (or be on a website
jn> only); that excludes many online tutorials and guides.

JN> Should "Version Control by Example" be included (it has a chapter on Git)?

#### About this survey. Open forum.

39. How did you hear about this Git User's Survey? ===
    (single choice, with other)

 * git mailing list
 * git-related mailing list (e.g. msysGit, Git for Human Beings)
 * mailing list or forum of some project
 * #git IRC channel topic
 * announcement on IRC channel
 * git homepage
 * git wiki
 * git hosting site (or blog related to such site)
 * software-related web site
 * news or social news site (e.g. Digg, Reddit)
 * blog (or blog planet)
 * other kind of web site
 * Twitter or other microblogging platform

 * other - please specify

jn> This list would of course be updated to reflect the list of (planned)
jn> announcement channels.  I also plan to use separate "channels"
jn> (separate shorter URLs) for different announcements.
jn> I'm not sure how useful would it be.

JN> I am considering dropping this question in favor of the next one.

40. How do you hear about git related news 
    (such as new releases and community events)?
    (multiple choice or single choice?, with other)

JN> This question was proposed by Andrew Ardill, with the proposal in
JN> Message-ID: 

  * I wasn't aware there was any news
  * I don't read any news, but I'm aware of it
  * through news aggregation sites (such as reddit or hacker news)
  * from a newsletter (such as Git Rev News)
  + through a watched blog (such as GitHub Blog)
  + announcement section in news site (such as LWN.net)
  + RelNotes file(s) in git sources
  * from a mailing list (such as the git developer or the git for windows list)
  * other, please specify

JN> Are there any other common channels that you (the people) watch for
JN> git news or software news?  Freshmeat / Freecode is defunct, and no
JN> replacement got popular enough...

41. Other comments and suggestions
    What other comments or suggestions do you have,
    that are not covered by the questions above?
    (essay length / textarea)

jn> This would be hard to analyze... but possibly useful.

Jakub Narębski

To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Reply via email to