From the first section of INSTALL.txt:

For detailed information on how to configure a test server environment using
a variety of operating systems and web servers, see "Local server setup"
(http://drupal.org/node/260) in the Drupal Handbook.

http://drupal.org/node/260 has been unpublished.

The attached patch slightly repurposes this paragraph, and points the link to http://drupal.org/node/157602.

CommentFileSizeAuthor
#2 installtxt_2.patch1016 byteskeith.smith
installtxt_1.patch992 byteskeith.smith

Comments

keith.smith’s picture

keith.smith commented
Status: Needs review » Needs work

Oops. Forgot to change the link.

keith.smith’s picture

keith.smith commented
Status: Needs work » Needs review
StatusFileSize
new installtxt_2.patch1016 bytes

OK. Let me try that again. This patch should point to http://drupal.org/node/157602.

greggles’s picture

greggles
he/him
Primary language English
Location Denver, Colorado, USA
commented
Status: Needs review » Reviewed & tested by the community

Applies cleanly, the text and handbook page look good to me, -> RTBC.

keith.smith’s picture

keith.smith commented

(Marked http://drupal.org/node/214270 as a duplicate of this one.)

gábor hojtsy’s picture

gábor hojtsy
he/him
Primary language Hungarian
Location Hungary
commented
Version: 6.x-dev » 5.x-dev

Committed to 6.x. I guess we also need to fix this in Drupal 5.

dww’s picture

dww
we/he/they
commented

For the record...

a) Why is INSTALL.txt pointing to a page buried relatively deep in the "Developing for Drupal" handbook? Why is http://drupal.org/node/157602 not located under http://drupal.org/getting-started ? We could certainly cross reference it from http://drupal.org/node/147786...

b) Why don't we use a level of indirection by means of a URL alias for this, instead of hard-coding nids into the INSTALL.txt files? E.g. http://drupal.org/getting-started/setup-server (or something)...

Btw, it was silly that INSTALL.txt contained a link to a handbook page that was itself a CVS checkout of INSTALL.txt. ;)

gábor hojtsy’s picture

gábor hojtsy
he/him
Primary language Hungarian
Location Hungary
commented
Status: Reviewed & tested by the community » Needs work

OK, get this into a nicer shape for D6 first.

greggles’s picture

greggles
he/him
Primary language English
Location Denver, Colorado, USA
commented

dww - I kind of agree with you but this is about setting up alternate/test environments. That's not "getting started" level stuff, right?

I would be happy to go with your idea of "link to #147786 and then link from #147786 to #157602"

I also like your b.

I'm not roling a patch since this requires discussion, not 20 patches that are subtly different.

gábor hojtsy’s picture

gábor hojtsy
he/him
Primary language Hungarian
Location Hungary
commented
Version: 5.x-dev » 6.x-dev
keith.smith’s picture

keith.smith commented
Version: 6.x-dev » 5.x-dev

Also for the record, on reading back through this, I misquoted the original text in #1 due to (I guess) a copy/paste error, including the new text in the code block rather than the original.

The original, from the patch, was:

-Guidelines for setting up a server environment with a variety of operating
-systems and in special cases are available in the Drupal handbook
-(http://drupal.org/node/260).

The original did not really have the meaning "test environment".

I added that, because:

  1. The closest page I found to configuring Drupal on a "variety of operating systems and in special cases" was the one I linked to, and it referenced a test environment.
  2. The paragraph, as it stood, was not that useful, and it didn't seem like a particularly good idea to be encouraging people to get creative via "special cases"; those that want to do that are likely to figure out how on their own.
  3. The installation of Drupal in a test environment has to be a strong use case, though, and it is one that probably needs some special instruction. So, the page I linked to seemed a good fit, and I changed the paragraph to fit that purpose.
  4. Since it was unpublished, I had no idea what the original page said.

Creating an alias for http://drupal.org/node/147786 and referencing that is a fine idea, especially if we keep the new meaning targeted for the "test" use case.

On the alias, http://drupal.org/getting-started/setup-server could be a page describing how to configure a production server. If the title of http://drupal.org/node/147786 is "Setting up a development environment", how about http://drupal.org/getting-started/development-tools?

dww’s picture

dww
we/he/they
commented

Disclaimer: I don't have much energy to spare on this discussion. Other than what I said above, all I have to add is:

- The URL alias should roughly match the actual handbook layout. If it's got "getting-started" as the top level path, the page itself should be under that section of the handbook, if possible.

- If we think this stuff should be linked to via INSTALL.txt, it should probably be written for the "getting started" crowd and put in that area of the handbook.

- I don't see how it makes much of a difference if it's setting up a server for production or a test environment. If you need to setup a server, you need to set it up, regardless of the use-case. Sure, people are more likely to be setting up test environments on their laptops than production servers, but it doesn't really seem to matter. If the instructions explain how to setup the required server stack, it should be called "Setting up a server to be able to run Drupal" or something, and the opening paragraph can say "Even if you already have a production server, you probably want to follow these instructions on your own workstation to setup a test server...".

That's how I see it, at least. But, I really can't spend much more effort in here, sorry. Too many other irons in the fire.

keith.smith’s picture

keith.smith commented
Version: 5.x-dev » 6.x-dev
Status: Needs work » Active

@dww: Completely understandable. Thanks for the input. Your point is certainly well-taken.

@all: If someone can create an alias for http://drupal.org/node/147786 along the lines of http://drupal.org/getting-started/setup-server, http://drupal.org/getting-started/development-tools, or something else reasonable, I'll roll a patch to replace the node reference in 6's INSTALL.txt with the new link, and a separate patch that can then be applied to 5.

I accidentally overwrote Gábor's version change to 6. Plus, the previous patch here has been committed, so resetting to "active".

dww’s picture

dww
we/he/they
commented

We need to decide on a good URL before one of us creates the alias.

jhodgdon’s picture

jhodgdon
she/her
Primary language English
commented
Version: 6.x-dev » 7.x-dev
Status: Active » Fixed

This whole thing seems to be somewhat out of date, to say the least...

The install.txt files in D7 and D6 now say:

For detailed information on how to configure a test server environment using
a variety of operating systems and web servers, see "Local server setup"
(http://drupal.org/node/157602) in the Drupal handbook.

I think this is OK. Please reopen if you think it needs updating.

Status: Fixed » Closed (fixed)

Automatically closed -- issue fixed for 2 weeks with no activity.