Clean up INSTALL.txt and update links [#1042706]

Changes made:

Added zip format as alternative in download and extract documentation.
Removed redundant empty lines used to separate sections. The other documentation files in Drupal core use 1 line to separate, not 2.
Title of 'Using Clean URLs with IIS' page has changed on drupal.org. Changed "name" of link to reflect this.
URL of translation downloads redirects to new URL. Changed to this new URL.
Spelling error.
Fixed some wrapping issues.
Handbook URL redirects to drupal.org/documentation. Changed handbook URL to reflect this change.
Is it called the handbook anymore? Not sure why the path alias was changed from handbook to documentation. If the name handbook is no longer valid, other changes are also necessary, but this patch does not change this.
Title of 'Security announcements' page has changed on drupal.org. Changed "name" of link to reflect this.

Comment	File	Size	Author
#15	INSTALL-documentation-addition-and-cleanup-5.patch	6.5 KB	Tor Arne Thune
#15
#11	INSTALL-documentation-addition-and-cleanup-4.patch	6.72 KB	Tor Arne Thune
#11
#7	INSTALL-documentation-addition-and-cleanup-3.patch	6.73 KB	Tor Arne Thune
#7
#3	INSTALL-documentation-addition-and-cleanup-2.patch	6.75 KB	Tor Arne Thune
#3
	INSTALL-documentation-addition-and-cleanup.patch	5.55 KB	Tor Arne Thune

Support from Acquia helps fund testing for Drupal Acquia logo

Comments

Comment #1

jhodgdon

she/her

English

CreditAttribution: jhodgdon commented 28 January 2011 at 14:52

Status:

Needs review

» Needs work

Yes, we have changed the name Handbook and the URL aliases. We should now use the phrase "Drupal.org on-line documentation" rather than "the Drupal Handbook". And yes, for whatever reason the standard is Drupal.org when referring to d.o in a sentence.

So let's make that change too, if you don't mind? By the way, the cleanup you are doing is appreciated! :)

Comment #2

Tor Arne Thune CreditAttribution: Tor Arne Thune commented 28 January 2011 at 15:37

Ignore, double post.

Comment #3

Tor Arne Thune CreditAttribution: Tor Arne Thune commented 28 January 2011 at 15:37

Status:

Needs work

» Needs review

File	Size
INSTALL-documentation-addition-and-cleanup-2.patch	6.75 KB

Sure thing. New patch attached where I have also changed all the instances of "Drupal handbook" with "Drupal.org on-line documentation".

By the way, before I forget it. On drupal.org/documentation, it still refers to the Drupal handbook in the "Help Us Write Documentation" box displayed in the right sidebar.

Comment #4

jhodgdon

she/her

English

CreditAttribution: jhodgdon commented 28 January 2011 at 15:54

Status:

Needs review

» Needs work

Thanks! We have an issue open to make that block better in general, which just hasn't been done yet. Thanks for the reminder (I just bumped it up to the top of the doc issue queue -- #995334: Improve the Help with Doc block if you are interested).

Regarding this patch, it all looks great except this seems a bit awkward (says documentation twice, which seems odd):

+- For additional documentation, see the Drupal.org on-line documentation:
+  http://drupal.org/documentation

Maybe it should say "information" for the first documentation word?... not sure that would be better, since the whole section is "more information"... Maybe it should just say:

- Drupal.org on-line documentation:

Comment #5

Tor Arne Thune CreditAttribution: Tor Arne Thune commented 28 January 2011 at 18:58

How about "See the Drupal.org on-line documentation"?

Comment #6

jhodgdon

she/her

English

CreditAttribution: jhodgdon commented 28 January 2011 at 19:06

works for me

Comment #7

Tor Arne Thune CreditAttribution: Tor Arne Thune commented 28 January 2011 at 19:32

Status:

Needs work

» Needs review

File	Size
INSTALL-documentation-addition-and-cleanup-3.patch	6.73 KB

Great. Makes it more of a complete sentence, without using the words "information" and "documentation". I guess we could use "instructions", but... I'm not sure.
Anyway, rolling a new patch with "See the Drupal.org on-line documentation:"

Comment #8

jhodgdon

she/her

English

CreditAttribution: jhodgdon commented 29 January 2011 at 00:32

Status:

Needs review

» Reviewed & tested by the community

Looks fine to me. Thanks!

Comment #9

Tor Arne Thune CreditAttribution: Tor Arne Thune commented 31 January 2011 at 00:26

I'm a bit unsure about "Drupal.org on-line documentation". In the style guide it says to use online instead of on-line. Should the style be updated?

Comment #10

arianek CreditAttribution: arianek commented 31 January 2011 at 01:17

Status:

Reviewed & tested by the community

» Needs work

yep, no dash in "Online documentation" pls (as per style guide guidelines http://drupal.org/node/338208#relatedwords and the actual page title http://drupal.org/node/338208). thx!

Comment #11

Tor Arne Thune CreditAttribution: Tor Arne Thune commented 31 January 2011 at 02:28

Status:

Needs work

» Needs review

File	Size
INSTALL-documentation-addition-and-cleanup-4.patch	6.72 KB

Done. Attached patch has "Drupal.org online documentation" instead of "Drupal.org on-line documentation."

Comment #12

jhodgdon

she/her

English

CreditAttribution: jhodgdon commented 31 January 2011 at 15:06

Status:

Needs review

» Reviewed & tested by the community

Thanks for clearing that up arianek! Patch looks good now.

Comment #13

Dries CreditAttribution: Dries commented 4 February 2011 at 21:16

I committed #1029346: INSTALL.txt and UPGRADE.txt should mention that you can download Drupal as a .zip file also earlier today before I found this patch. It might clash with this patch. Haven't had time yet to figure that out yet so just adding a note for now.