Questions for docs, part 1

[Simon Green]

On 26/07/14 01:20, Gervase Markham wrote:
> * Under what circumstances do people need to use a tarball to install
>   or upgrade? Is it only if they have no network connection?

I would expect the vast majority of user would use the tarball over VCS.
It's easier to get a gz file than it is to install git, and try and
figure out the right command. I'm basing this on the assumption that
most companies that use Bugzilla have sysadmins whos skills can be
described as beginner to immediate.

> * Should we recommend using Git (over tarballs) wherever possible?

Definitely make a note in the guide, but I think for the lowest barrier
to entry, the quick start guide should use the .tar.gz file. Sysadmins
know what to do with that file :)

> * Do our tarballs come with VCS information? 

Yes, .bzr exists in these directories (
http://ftp.mozilla.org/pub/mozilla.org/webtools/bugzilla-4.4.5.tar.gz at
least)

Surprisingly, 4.5.5 also has a .bzr directory even though there won't be
a 5.0 bzr repo, IIRC. dkl or mcote will be able to clarify.

> If so, does
>   that mean everyone actually has a VCS checkout, and can upgrade using
>   a VCS method?

Yes.

> * I'm writing a Quick Start guide - a simple 1, 2, 3 to get Bugzilla up
>   and running using Ubuntu 14.04 LTS, MySQL and Apache. Do I describe
>   Ubuntu Server (supported for longer) and a console install, or Ubuntu
>   Desktop so they can use a graphical text editor and web browser?

Ubuntu Server LTS. I'm going to assume even a beginner sysadmin knows
how to edit a file from the command line.

-- 
Simon Green
Software Engineer
Red Hat Asia Pacific Pty Ltd