<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<link rel="home" title="HomePage" href="HomePage.html" />
<link rel="help" title="HowToUseWiki" href="HowToUseWiki.html" />
<link rel="copyright" title="GNU General Public License" href="http://www.gnu.org/copyleft/gpl.html#SEC1" />
<link rel="author" title="The PhpWiki Programming Team" href="http://phpwiki.org/ThePhpWikiProgrammingTeam" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta http-equiv="Content-Language" content="en" />
<meta name="robots" content="noindex,nofollow" />
<meta name="language" content="en" />
<meta name="document-type" content="Public" />
<meta name="document-rating" content="General" />
<meta name="generator" content="PhpWiki" />
<meta name="PHPWIKI_VERSION" content="1.3.14" />

<link rel="stylesheet" type="text/css" charset="iso-8859-1" href="phpwiki-printer.css" />
<title>PhpWiki - Basic How To pages overview</title>
</head>
<body>

<div id="header">
  
<!-- Page title -->
<h1>Basic How To pages overview</h1>
</div>
<div id="content">



<div class="wikitext"><h2>The How To Classification Pages</h2>
<table class="wiki-dl-table" border="1" cellspacing="0" cellpadding="6"><tr class="tightenable"><th><i>Nav Bar</i></th>
<th><a href="Documentation.html" class="wiki">Documentation</a></th>
<th><a href="How-to%20Classification.html" class="wiki">How-to Classification</a></th>
<td><a href="Web%20Miscellaneous.html" class="wiki">Web Miscellaneous</a></td>
</tr>
</table>
<p class="tightenable">These pages were created in response to requests to build a better interface to all the many contribs that various people have posted over the last 5 years. It's supposed to make it easier to get an idea of what's out there, not judge how good they are, or who made them first, etc. The community is going to have to answer questions like that - the aim here is just to list them all. If we find multiple different How Tos for the same procedure, we should list them all.</p>
<h3>History (correct me if I misremember, guys :-)</h3>
<p class="tightenable top">The basic idea for this list was suggested by Ian Wells, who put together a Classification list from the one at e-smith.org and other spots. Hsing-Foo built the original page in an earlier wiki we were trying out, and we put some How tos into it. When we moved to the present wiki, we moved them over and started building the list.</p>
<h3>Contributors</h3>
<ul><li class="tightenable bottom">Hsing-Foo Wang</li>
<li class="tightenable top bottom">Ian Wells</li>
<li class="tightenable top">Ron McNew</li>
</ul>
<h3>Nomenclature</h3>
<p class="tightenable top bottom">(from an email from Ian Wells) <br /></p>
<blockquote class="tightenable top"><p class="tightenable top bottom">Classification Page = The Long List <br />
Topic Page = the page reached from the long list, for example the Hardware Page <br />
Meta-data page = the page that describes an actual How To. <br />
(also there is a Feedback Page) <br /></p>
</blockquote>
<h3>The Classification Page</h3>
<p class="tightenable top">This page was built as told above, and has had a few items added since. There are obvious problems with this approach, for instance overlapping categories, and missing categories that don't fit into the namespace very well - it would make a very bad database design. Fortunately, we are not aiming at architectural purity, but at ease-of use, and if a Meta-data page ends up needing to be linked to from multiple Topic Pages, it's ok.</p>
<h3>Topic Page</h3>
<p class="tightenable top bottom">Built from a template - has three sections:</p>
<ul><li class="tightenable top bottom">Local Resources - for wiki pages hosted at Contribs.org. These can be linked to directly (without an intervening meta-data page, but of course the info should still be put into the wiki how to document.</li>
<li class="tightenable top bottom">External Resources - for standard web pages, whether hosted by contribs, or elsewhere. We're trying to add a short description after each link (eventually)</li>
<li class="tightenable top">Additional Information - links to related external sites, for background or explanation of the topic.</li>
</ul>
<h3>The Meta-data page</h3>
<p class="tightenable top bottom">Built from a template - besides meta-data (who, what, when), we're trying to provide a summary to help people decide if they want to go further. Otherwise, it has a link to the How to, and the How to itself in an iframe. It has seven sections:</p>
<ul><li class="tightenable top bottom">Title</li>
<li class="tightenable top bottom">Meta-data (includes top Nav Bar)</li>
<li class="tightenable top bottom">About this How To</li>
<li class="tightenable top bottom">The How To itself</li>
<li class="tightenable top bottom">The bottom Nav Bar</li>
<li class="tightenable top bottom">Link to Feed Back wiki page</li>
<li class="tightenable top">List of wiki pages that link to this page</li>
</ul>
<h3>Feedback Page</h3>
<p class="tightenable top">Built from a template - basically a blank wiki page for each How to, to try and encourage feedback. I hope we can replace this one day with a Forum Thread link and iframe.</p>
<table class="wiki-dl-table" border="1" cellspacing="0" cellpadding="6"><tr class="tightenable bottom"><th><i>Nav Bar</i></th>
<th><a href="Documentation.html" class="wiki">Documentation</a></th>
<th><a href="How-to%20Classification.html" class="wiki">How-to Classification</a></th>
<td><a href="Web%20Miscellaneous.html" class="wiki">Web Miscellaneous</a></td>
</tr>
</table>
</div>

<div id="footer">  <hr class="printer" noshade="noshade" />
<p class="editdate">Owner: &quot;RonM&quot;  Last edited on November 5, 2004  1:12 pm by &quot;RonM&quot;</p>
</div>

</div>
<!-- Add your Disclaimer here -->
</body>
</html>
