simon/wildwood
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Analysis and History chapters are now readable.

Browse source 
Further proof reading needed!
This commit is contained in:
Simon Brooke 2020-04-22 17:04:26 +01:00
parent 04c3973ef5
commit 4a2f7283b6
No known key found for this signature in database
GPG key ID: A7A4F18D1D4DF987
23 changed files with 1071 additions and 1731 deletions
Download patch file Download diff file Expand all files Collapse all files

16
docs/codox/History.html
View file

@ -1,6 +1,6 @@
<!DOCTYPE html PUBLIC ""
"">
<html><head><meta charset="UTF-8" /><title>History</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name">Wildwood</span> <span class="project-version">0.1.0-SNAPSHOT</span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="AgainstTruth.html"><div class="inner"><span>Against Truth</span></div></a></li><li class="depth-1 "><a href="Analysis.html"><div class="inner"><span></span></div></a></li><li class="depth-1 "><a href="Errata.html"><div class="inner"><span>Errata</span></div></a></li><li class="depth-1 current"><a href="History.html"><div class="inner"><span>History</span></div></a></li><li class="depth-1 "><a href="Manifesto.html"><div class="inner"><span></span></div></a></li><li class="depth-1 "><a href="PredicateSubtext.html"><div class="inner"><span></span></div></a></li><li class="depth-1 "><a href="TheProblem.html"><div class="inner"><span>The Problem</span></div></a></li><li class="depth-1 "><a href="intro.html"><div class="inner"><span># Introduction to Wildwood</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="wildwood.core.html"><div class="inner"><span>wildwood.core</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#history" name="history"></a>History</h1>
<html><head><meta charset="UTF-8" /><title>History</title><link rel="stylesheet" type="text/css" href="css/default.css" /><link rel="stylesheet" type="text/css" href="css/highlight.css" /><script type="text/javascript" src="js/highlight.min.js"></script><script type="text/javascript" src="js/jquery.min.js"></script><script type="text/javascript" src="js/page_effects.js"></script><script>hljs.initHighlightingOnLoad();</script></head><body><div id="header"><h2>Generated by <a href="https://github.com/weavejester/codox">Codox</a></h2><h1><a href="index.html"><span class="project-title"><span class="project-name">Wildwood</span> <span class="project-version">0.1.0-SNAPSHOT</span></span></a></h1></div><div class="sidebar primary"><h3 class="no-link"><span class="inner">Project</span></h3><ul class="index-link"><li class="depth-1 "><a href="index.html"><div class="inner">Index</div></a></li></ul><h3 class="no-link"><span class="inner">Topics</span></h3><ul><li class="depth-1 "><a href="AgainstTruth.html"><div class="inner"><span>Against Truth</span></div></a></li><li class="depth-1 "><a href="Analysis.html"><div class="inner"><span>Analysis</span></div></a></li><li class="depth-1 "><a href="Arboretum.html"><div class="inner"><span>Arboretum</span></div></a></li><li class="depth-1 "><a href="Conception.html"><div class="inner"><span>Conception</span></div></a></li><li class="depth-1 "><a href="Errata.html"><div class="inner"><span>Errata</span></div></a></li><li class="depth-1 current"><a href="History.html"><div class="inner"><span>History</span></div></a></li><li class="depth-1 "><a href="Manifesto.html"><div class="inner"><span></span></div></a></li><li class="depth-1 "><a href="OnHylasAndPhilonus.html"><div class="inner"><span>On the First Dialogue of Hylas and Philonous</span></div></a></li><li class="depth-1 "><a href="PredicateSubtext.html"><div class="inner"><span></span></div></a></li><li class="depth-1 "><a href="TheProblem.html"><div class="inner"><span>The Problem</span></div></a></li><li class="depth-1 "><a href="intro.html"><div class="inner"><span># Introduction to Wildwood</span></div></a></li></ul><h3 class="no-link"><span class="inner">Namespaces</span></h3><ul><li class="depth-1 "><a href="wildwood.core.html"><div class="inner"><span>wildwood.core</span></div></a></li></ul></div><div class="document" id="content"><div class="doc"><div class="markdown"><h1><a href="#history" name="history"></a>History</h1>
<h2><a href="#history-introduction" name="history-introduction"></a>History: Introduction</h2>
<p>The object of this chapter is to describe and discuss the development of Expert System explanations from the beginning’ to the most recent systems. The argument which I will try to advance is that development has been continuously driven by the perceived inadequacy of the explanations given; and that, while many ad hoc, and some principled, approaches have been tried, no really adequate explanation system has emerged. Further, I will claim that, as some of the later and more principled explanation systems accurately model the accounts of explanation advanced in current philosophy, the philosophical understanding of explanation is itself inadequate.</p>
<h2><a href="#family-tree-of-systems-discussed" name="family-tree-of-systems-discussed"></a>Family Tree of Systems discussed</h2>
@ -362,13 +362,17 @@ we shall set up testers for 2273 of card1 in quarter 3
<p>The application here is to the adjudication of claims to health insurance benefits. The system would be used by the adjudication officer, and the explanation would be sent to the claimant.</p>
<pre><code>Dear [Name of Claimant]
You are capable of work and there are no special circumstances permitting you to be deemed incapable of work. Although you provided a valid certificate of explanation, this is insufficient unless either there is evidence of contact with the disease or you are a known carrier thereof.
Although physically capable of work you may
nonetheless be deemed incapable of work today. You are
deemed incapable of work for precautionary reasons. You
are deemed incapable of work on precautionary grounds
as you are under medical care, and your doctor has
recommended that you abstain from working.
Yours Sincerely
[your name]
</code></pre>
<p>TODO: this is not a very good Arboretum explanation; I know we did better ones on Widows’ benefit. Check whether I can find a surviving good one, and substitute it.</p>
<h3><a href="#discussion" name="discussion"></a>Discussion</h3>
<p>It will be seen that this is a short, clear, declarative statement in seemingly natural English, which covers all (and only) the relevant points of a complex case. To be fair, the system does not always do this well, but most of its explanations are of this quality.</p>
<h1><a href="#attempts-at-more-principled-approaches" name="attempts-at-more-principled-approaches"></a>Attempts at more principled approaches</h1>
@ -408,7 +412,11 @@ Yours Sincerely
<pre><code>(EXPLAIN (SHOW &lt;assertion&gt;))
</code></pre>
<h3><a href="#example-explanation-" name="example-explanation-"></a>Example explanation:</h3>
<pre><code>Well, Peter makes less than 750 dollars, and Peter is under 19, and Harry supports Peter so Peter is a dependent of Harry's. Uh Peter makes less than 750 dollars because Peter does not work, and Peter is a dependent of Harry's because Harry provides more than one half of Peter's support.
<pre><code>Well, Peter makes less than 750 dollars, and Peter is under 19, and
Harry supports Peter so Peter is a dependent of Harry's. Uh Peter
makes less than 750 dollars because Peter does not work, and Peter
is a dependent of Harry's because Harry provides more than one half
of Peter's support.
</code></pre>
<p>I should explain that the application is to the US Federal Income Tax system. This explanation does indeed capture something of the flavour of a natural spoken explanation. Furthermore, it is clearly declarative rather than procedural. However, personally, I find its style rather too informal for textual presentation. I particularly dislike the meaningless ‘Uh’ which is use to tag the supporting point.</p>
<h3><a href="#discussion" name="discussion"></a>Discussion</h3>