272347 - Get the Windows install guide either moved into the documentation or the Bugzilla website

Status: RESOLVED FIXED

(Bugzilla :: bugzilla.org, defect)

Description

[Dave Miller [:justdave]]

We have a pressing need (like before December 1st?) to get the "Installing
Bugzilla on Windows" guide off of Byron's website.  As it turns out, the page
has wound up being immensely popular, and he's pushed over a gigabyte of traffic
from his website for the month of November so far.  And this hasn't exactly made
his ISP happy ("it's over 10 times the traffic generated by any other site
hosted on the ISP" I believe is what he said).

bugzilla.org has more than enough bandwidth available to handle it.

The page doesn't need to stay 100% intact, we just need to make sure the content
all makes it (the step by step, and ideally the screenshots as well).  Having it
in the os-specific section in the docs probably wouldn't hurt.

Comment 1

[:glob ✱]

Attachment: modifications to .htaccess and bugzilla.css for the win32 guide

Comment 2

[:glob ✱]

Attachment: index.html.tmpl

Comment 3

[:glob ✱]

Attachment: mysqlcc.png

Comment 4

[:glob ✱]

Attachment: regedit.png

Comment 5

[:glob ✱]

Attachment: t_mysqlcc.png

Comment 6

[:glob ✱]

Attachment: t_regedit.png

Comment 7

[:glob ✱]

ok, that's all the files.

they probably should live under /docs/windows

Comment 8

[Dave Miller [:justdave]]

Comment on attachment 167396 [details] [diff] [review]
modifications to .htaccess and bugzilla.css for the win32 guide

>--- .htaccess	26 Sep 2004 05:43:58 -0000	1.5
>+++ .htaccess	30 Nov 2004 05:16:20 -0000
>@@ -5,6 +5,6 @@
> # exempt anything in a subdirectory under docs from getting rewritten
>-RewriteRule ^docs/.+/ - [L]
>+#RewriteRule ^docs/.+/ - [L]

We can't remove this or it will break the real docs.

We can probably get the rest of that stuff into the css file though.  (are you
sure there aren't equivalents to them already in our css?  We inherit a few CSS
files from mozilla.org as well, that have a ton of stuff in them)

Comment 9

[:glob ✱]

Attachment: bugzilla.css changes

ah, silly me.  sorry.

there were a few classes that came close (eg .terminal), but none that i really
liked (eg .terminal has a which background).

Comment 10

[Shane H. W. Travis]

Byron;

First of all, thanks for taking the time to write these up. I am not one of the 
people who uses Bugzilla on Windows, but as I've been looking through all the 
documentation bugs it seems like a LOT of them are related to this very issue. 
Kudos to you for taking the time to do a good job of documenting the install 
process.

As to the specific attachments above; am I safe to assume that they are simply 
copies of the actual files from your website, and not actual patches for the 
Bugzilla docs? If that's the case, are you planning to get them into shape for 
addition into the documentation, or were you just wanting to get them somewhere 
safe before they disappeared? I ask because you have assigned this to you, 
indicating that you are going to do all the work up to the point where they are 
ready for inclusion... but if that's not the case, please speak up and I'll do 
what I can to get them kicked into shape ASAP.

Comment 11

[:glob ✱]

to be honest i don't think that it belongs in "the documentation", due to its
vebosity, tone and limited target audience.

i think it is a better candidate for a new page on the bugzilla.org website,
which is why it is in the format that i attached.

it isn't a copy from my website, i modified them to use bugzilla.org's existing
template structure, and changed some of the wording and entries to better suit a
bugzilla.org hosted page.

you can see it in action at http://www.justdave.net/bugzilladev/win/

Comment 12

[:glob ✱]

note that the page is linked from the bugzilla download page.  once a new home
is found, that link will have to be updated (i can do a patch for that).

Comment 13

[:glob ✱]

i've taken down the page from bugzilla.glob.com.au :(

Comment 14

[Dave Miller [:justdave]]

OK, it's now live (or will be within the next 10 minutes) at
http://www.bugzilla.org/docs/win32install.html

Comment 15

[:glob ✱]

excellent, thanks :)

Comment 16

[Shane H. W. Travis]

I will be adding a link to this document into my FAQ update (bug 267873), and 
we should probably make mention of it elsewhere in the documentation... like in 
the OS-Specific Installation Notes (section 2.4 in the current 2.18rc3 
documentation).

Excellent work, Byron... it looks like a hugely valuable resource for those who 
need it!