[tahoe-lafs-trac-stream] [tahoe-lafs] #1701: remove link to wiki:AdvancedInstall from quickstart.rst

tahoe-lafs trac at tahoe-lafs.org
Sat Mar 31 04:34:18 UTC 2012


#1701: remove link to wiki:AdvancedInstall from quickstart.rst
---------------------------+---------------------------
 Reporter:  zooko          |          Owner:  somebody
     Type:  enhancement    |         Status:  new
 Priority:  normal         |      Milestone:  undecided
Component:  documentation  |        Version:  1.9.1
 Keywords:                 |  Launchpad Bug:
---------------------------+---------------------------
 John Dougherty was just trying to install tahoe-lafs. He asked me for
 help, saying something like "I'm failing at installing Twisted". I said
 something like "whoa whoa whoa -- who told you to install Twisted?".
 (Because my preference is that Twisted gets installed automatically, if
 needed, by the build process.) He showed me how he was following
 wiki:AdvancedInstall and going through the list of dependencies trying to
 manually install them. I said something like "Aurgh! How did you get to
 this page?". He showed me that he had gotten to it by following the link
 at the end of  source:docs/quickstart.rst . I said something like "I have
 made the text surrounding that link as forbidding as I can! It tells you
 not to follow the link. Why did you follow the link?". He said something
 like "Well I scanned this document for a list of dependencies to manually
 install, and I didn't see on, so I followed the link at the bottom named
 'something Install something', and then I saw a list of dependencies to
 manually install.".

 My conclusion is that the only way to keep people from wandering into
 wiki:AdvancedInstall and getting bogged down in the quicksand pits that we
 keep there is to remove the link to there from quickstart.rst.

-- 
Ticket URL: <https://tahoe-lafs.org/trac/tahoe-lafs/ticket/1701>
tahoe-lafs <https://tahoe-lafs.org>
secure decentralized storage


More information about the tahoe-lafs-trac-stream mailing list