Opened 12 years ago

Closed 11 years ago

Last modified 11 years ago

#15392 closed enhancement (fixed)

Guide and install.php should be synced and subversion installs expanded

Reported by: wsiegrist@… Owned by: wms@…
Priority: Low Milestone:
Component: guide Version:
Keywords: guide documentation website Cc: ryandesign (Ryan Schmidt)
Port:

Description

The installation instructions in the guide should be synced with whats in install.php. Also, the instructions for subversion installs should make it obvious which step in the source install to go to after the checkout (only) step is performed from install.php. The guide does not mention installing from an svn checkout at all.

Change History (6)

comment:1 Changed 12 years ago by markd@…

I'd favor rolling the "other platforms" information into a separate html page that is linked in both docs, since the readership is small it should not be obtrusive, and it also provides a single source. The install section of the guide does need info on subversion installs. It could easily be tucked into the "source installs" section. I'll add something for that in the next few days. If we could agree on when we have an adequate guide install section, perhaps we could just transform the xml of the guide's install section into install.php, thereby also giving a single source.

I think install.php has too much information subject to change (v2.4.1, v 3.0, "Panther PPC", etc) that can be simplified ("latest Xcode _here_"). But then I wrote the install section of the guide and so I'm not an unbiased observer. I favor a minimalist approach, and some questions will always have to be answered by the mailing list anyway.

comment:2 Changed 11 years ago by ryandesign (Ryan Schmidt)

Milestone: Website & Documentation

There are instructions for building MacPorts from the Subversion trunk in the wiki howto page RunningTrunk. Perhaps that could be used as the basis for the new Guide information.

We sorely need a single document for installation instructions. I wouldn't even mind if install.php were nothing but a single sentence directing people to the relevant page in the Guide.

See also #17359.

comment:3 Changed 11 years ago by ryandesign (Ryan Schmidt)

Cc: ryandesign@… added

comment:4 Changed 11 years ago by wsiegrist@…

r44116 added the new section to the guide. I think we should leave the "Keeping up to Date" section in HOWTO, and replace the top half with a link to the guide. Then we can replace the section in install.php with a link to the guide.

comment:5 Changed 11 years ago by wsiegrist@…

Resolution: fixed
Status: newclosed

I removed the obsolete sections from the HOWTO and install.php. See r45346 and the wiki change.

comment:6 Changed 11 years ago by (none)

Milestone: Website & Documentation

Milestone Website & Documentation deleted

Note: See TracTickets for help on using tickets.