rattail/appypod-rattail
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

[doc] In the process of updating documentation and website.

Browse source
This commit is contained in:
Gaetan Delannay 2012-09-12 00:23:34 +02:00
parent 6801188496
commit dc76ca542a
11 changed files with 144 additions and 68 deletions
Download patch file Download diff file Expand all files Collapse all files

69
doc/index.html
View file

@ -4,24 +4,55 @@
<link rel="stylesheet" href="appy.css" type="text/css">
</head>
<body>
<p>Appy (<b>Ap</b>plications in <b>py</b>thon) is a bunch of tools distributed under the <a href="http://www.gnu.org/copyleft/gpl.html">GPL license</a> for developing applications in the <a href="http://www.python.org">Python</a> programming language. The framework features two main modules: <a href="gen.html"><b>gen</b></a> and <a href="pod.html"><b>pod</b></a>.</p>
<h1>Developers, too, have the right to (h)appyness !</h1>
<p>Developers are often guys that live on another planet. Some think this is because software development is so exciting that everything else is poorly considered. At Null-IT software, we are deeply convinced that most developers do not enjoy themselves. They spend their lives together with complex problems that never go away from their minds. Nobody understands them. Their family? Their managers? Their clients? Their friends? No. Nobody. Nobody is able to imagine how huge and complex their tasks are. Consequently, what they do is underestimated. Worst: they can't communicate. Don't believe this is due to some intrinseque geek attitude. Their geekness results from the global incapacity to apprehend the very nature of their abilities. So they are forced to work harder while experiencing the true impossibility to share their permanent software experience. Of course, it may lead to social disasters.</p>
<p>By publishing this high-level, easy-to-use software construction kit, itself based on the tremendously productivity-boosting Python programming language, our crazy hope is to empower developers in such a way that they can leave more often their software prison and spend more time to discover real life.</p>
<p>But (h)appyness has a price. Appy developers themselves accepted to pay. They have dealed their social life for one of the highest forms of social denial (sorry we can't reveal their working conditions), hoping their sacrifice will free the users of their work. So if one day you meet one of them, please be gentle and patient. But they will probably not discuss with you.</p>
<h1>The null-IT principle</h1>
<p>Our action is guided by the following principle:</p>
<h2>Information Technology (IT) should be as transparent and invisible as possible.</h2>
<p>While this may seem obvious, this principle is largely ridiculed by a great number of widespread technologies. I will mention here JEE and XSL-FO which were taken as counter-examples while developing <a href="pod.html">pod</a>. In the Python world, Zope 3, by trying to mimick the ridiculous JEE component-model where code is viciously chopped into undersized chunks interconnected by obscure XML declarations, falls unfortunately into this category as well. This is a pity seeing Zope guys trying to abandon the elegant, simple, powerful (in a word: Pythonic) design of Zope 2. But don't be scared! Many people think that Zope 2 will last for many years... Null-IT, with others, is working hard to fight against the generalized Balkanization attitude that undermine IT innovation. If you believe there is still place for hope, you came at the right site. It is time to discover <a href="gen.html">gen!</a></p>
<p>The Appy framework needs Python 2.4 or higher.</p>
<!-- gen -->
<table cellpadding="0" cellspacing="0" align="center" width="80%" class="homeTable">
<tr valign="top">
<td width="100px" align="center" style="font-size: 95%">
<img src="img/gen.png" style="margin-bottom: 7px"/><br/>
<a href="gen.html">Get started</a><br/>
<img src="img/star.png"/><br/>
<a href="genCreatingBasicClasses.html">User guide</a><br/>
<img src="img/star.png"/><br/>
<a href="genCreatingAdvancedClasses.html">Reference guide</a>
</td>
<td>
<b>gen</b> - Create web apps without knowing anything about web technologies. Just pure Python.<br/><br/>
You are a small team? A one-man-show? You are bored with technicals details preventing you
from being creative and productive? You think conceptual but prefer coding over drawing? You want to do more
with less effort? You consider code as an art? You know that beauty comes with simplicity?
gen is made for you.<br/><br/>
<span style="font-size: 95%">
<i>Some people say I will kill my business by publishing my secret weapon.
What more soothing suicide could I dream than Appy's wide adoption?</i>
<div align="right">Ga&euml;tan Delannay, risk manager.</div>
</span>
</td>
</tr>
</table>
<!-- pod -->
<table cellpadding="0" cellspacing="0" align="center" width="80%" class="homeTable">
<tr valign="top">
<td width="100px" align="center" style="font-size: 95%">
<img src="img/pod.png" style="margin-bottom: 7px"/>
<a href="pod.html">Get started</a><br/>
<img src="img/star.png"/><br/>
<a href="podWritingTemplates.html">User guide</a><br/>
<img src="img/star.png"/><br/>
<a href="podWritingAdvancedTemplates.html">Reference guide</a>
</td>
<td>
<b>pod</b> - Create dynamic documents in .pdf, .doc, .odt or .rtf in a few minutes.<br/><br/>
Producing dynamic reports can be SO simple. Use Libre/OpenOffice to create a document template, write some Python
expressions in it, launch pod and you're done. pod (<b>P</b>ython <b>O</b>pen <b>D</b>ocument)
wants to be as smaller as possible. Use your word processor as much as you can. Then switch to
pod only for the tricky things.<br/><br/>
<span style="font-size: 95%">
<i>During the dark ages of software development, creating a single page of report with JEE and XSL-FO
could took up to 2 weeks. Since Ga&euml;tan made pod, the same task can be done in ten minutes.</i>
<div align="right">Damien Hubaux, paradigm-shift detector.</div>
</span>
</td>
</tr>
</table>
</body>
</html>