Questions for docs, part 1

[Damien]

On Sun, Jul 27, 2014 at 3:51 AM, Simon Green <sgreen at redhat.com> wrote:

> 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.
>

In my case, we have sysadmins, and we have a "tools" team.
Tools team maintains a git clone of bugzilla with a branch that contains
all customizations and extensions needed. They know how to spell git.

IMHO, nobody would use a tarball unless it contains their customizations;
or they also maintain a bunch of patches somewhere that they can apply.


>
> > * 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 :)
>

To me, someone who doesn't know what a VCS is, is not a team player.
Most concepts are portable.
https://try.github.io/
http://gitimmersion.com/


>
> > * 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.
>

The 2 sysadmins I have to work with have no love for ubuntu (e.g. config
files in a totally
different place than other distros.). They are from a RHEL/CentOS
background.
I think any documentation better than none is a great idea though.

Server over desktop, clearly. Sysadmins can have ubuntu desktop on their
own machine;
they can do scp if they can't work with vim or nano.

I got a page for a different stack:
https://wiki.mozilla.org/Bugzilla:Installation_with_nginx
see if there is anything of interest there.

Regards,
Damien.
_______________________________________________
dev-apps-bugzilla mailing list
dev-apps-bugzilla at lists.mozilla.org
https://lists.mozilla.org/listinfo/dev-apps-bugzilla