none

diff --git a/TWiki/AdminSkillsAssumptions.mdwn b/TWiki/AdminSkillsAssumptions.mdwn
new file mode 100644 (file)
index 0000000..4bfe8ed
--- /dev/null
+++ b/TWiki/AdminSkillsAssumptions.mdwn
@@ -0,0 +1,16 @@
+# <a name="Administrator Skills Assumptions"></a> Administrator Skills Assumptions
+
+For each of these, the requirement is either pre-existing knowledge/skill, or the willingness to spend significant time (i.e. from hours to days) learning these.
+
+- **Operating system administration:** Ability to use Unix/Linux command line tools (or equivalent Windows tools), including ability to move/copy/delete files, change permissions, view web server log files, set environment variables, use a text editor, etc.
+- **Web server administration:** Ability to do basic setup, e.g. ability to edit config files or use GUI configuration tools to enable CGI scripts on a directory.
+- **Program compilation:** Where RCS is not pre-installed (that is most Unix systems), the ability to download and compile the RCS program from source, including use of `configure`, `make`, etc. This is normally not necessary on Linux or Windows.
+- **Troubleshooting**: Ability to perform tests, inspect error logs, talk to technical support (whether in an IT department or web hosting provider) and read documentation in order to help with diagnosing installation problems.
+
+Installing TWiki is **not** recommended for people who only know HTML and web design, unless they are willing to learn the above, or team up with someone who can handle the installation.
+
+Although the [[TWikiInstallationGuide]] is quite complete, there will on occasion be parts that don't work in your local environment (particularly with TWiki:Codev/TWikiOnWebHostingSites, which are sometimes challenging even for those with good OS and web server skills).
+
+There are many excellent resources for learning how to administer your OS and web server, including books, web sites, web forums and email lists. The TWiki:Support web is not one of these - in other words, it is not there to answer basic questions about operating system and web server administration. Asking and answering questions is time consuming for all concerned and is best used for specific TWiki related issues, rather than helping you learn the OS and web server.
+
+-- [[RichardDonkin]] - 27 Apr 2002

diff --git a/TWiki/TWikiInstallationGuide.mdwn b/TWiki/TWikiInstallationGuide.mdwn
index 8c41e73..de47081 100644 (file)
--- a/TWiki/TWikiInstallationGuide.mdwn
+++ b/TWiki/TWikiInstallationGuide.mdwn
@@ -32,13 +32,14 @@ These installation steps are based on the **Apache** web server on **Linux**. TW
 - For Unix or Linux, check TWiki:Codev/TWikiOnUnix and TWiki:Codev/TWikiOnLinux.
 - For Windows, check the [[WindowsInstallCookbook]].
 - For MacOS X, check TWiki:Codev/TWikiOnMacOSX.
+- To install TWiki on SourceForge, for use on a software development project, read TWiki:Codev/TWikiOnSourceForge
 - For other platforms, see TWiki:Codev/TWikiOn, and search the TWiki:Codev and TWiki:Support webs for other installation notes.
 
 <a name="StandardInstallation"></a>
 
 ## <a name="Standard Installation"></a> Standard Installation
 
-Request and download the TWiki 01-Dec-2001 distribution in Unix ZIP format from <http://TWiki.org/download.html>. _(To install TWiki on SourceForge, for use on a software development project, read TWiki:Codev/SourceForgeHowTo .)_
+Request and download the TWiki 01-Dec-2001 distribution in Unix ZIP format from <http://TWiki.org/download.html>. Please review the [[AdminSkillsAssumptions]] before you install TWiki.
 
 ### <a name="Step 1: Create  Configure the Di"></a> Step 1: Create &amp; Configure the Directories
 

diff --git a/TWiki/WebHome.mdwn b/TWiki/WebHome.mdwn
index 525c3f7..e2e9f78 100644 (file)
--- a/TWiki/WebHome.mdwn
+++ b/TWiki/WebHome.mdwn
@@ -71,7 +71,7 @@
 
 <a name="ReferenceManual"></a>
 
-## <a name="TWiki Configuration Manual"></a> TWiki Configuration Manual
+## <a name="TWiki Reference Manual"></a> TWiki Reference Manual
 
 Documentation for webmasters, system administrators, project managers, team <br /> leaders, and all other users of the TWiki advanced online collaboration tool.
 
@@ -95,13 +95,9 @@ Documentation for webmasters, system administrators, project managers, team <br
   17. [[Managing Topics|Main/ManagingTopics]]
   18. [[Managing Webs|Main/ManagingWebs]]<br />**Appendices**<br />[[A. TWiki File System|Main/AppendixFileSystem]]<br />[[B. TWiki Development Timeline|Main/TWikiHistory]]
 
-## <a name="TWiki Reference"></a> TWiki Reference
-
-- [[Demonstrating TWiki|Main/TWikiCourseOutlineExample]]
-
 ## <a name="TWikiSiteTools"></a><a name="_TWikiSiteTools"></a> TWikiSiteTools
 
-[[TWikiSiteTools]] include utilities for navigation and for monitoring TWiki web and site-wide activity.
+- [[TWikiSiteTools]] include utilities for navigation and for monitoring TWiki web and site-wide activity.
 
 - [[TWikiPreferences]]: %WIKITOOLNAME% site-wide preferences
 - [[InstalledPlugins]]: currently available TWiki add-on features