Since release 26, Pliant does not adopt the classical file tree layout (the source code in one branch, the executables in another, data in a third branch and finally the documentation in a fourth) but a more innovative all together layout. The old layout was mainly intended to help storage administration (backup of data only and remote hosting of some readonly areas of the tree). The new one is intended to foster a tighter link between the documentation and the source code, which is even more important for public domain software.
I have noticed that the weakest part of current free software is generally documentation (I also note that undocumented code is still much better than no code at all). This is really a pity because when a project becomes non trivial, good documentation that helps advanced end users to dig in only the part of the code they need to improve is a key issue in order to get good contributions, which are the heart of high quality free software.

The Pliant default style for the .page file format used by Pliant documentation is intended to help build top quality software documentation. Most of it should be very easily understandable. Only the icon (which you will find in many places) needs a specific explanation: it is used to point out the application layout documentation (not the end user one) from the end user application, or to point out the source code from the general documentation. I decided to introduce a special icon for that so that we can have many many of these pointers without using text links such as documentation or source code that take more room on your screen and don't provide any more information icon.


Let's take an example:

for variable start stop [step step]
  body

is the classic 'for' operator available in any language.