Hi,
About active essays and writing documentation inside Pharo, I'm trying
to bring some experience on writing using a tree/outliner like interface
for it. Questions are in another thread, but I hope to help with some
kind of "dynabooklets", for the moment using pandoc's markdown, wich
seems better known and suited for academical writing, but may be at some
point it can share some Pillar insights.
Cheers,
Offray
On 05/30/2014 11:12 AM, kilon alios wrote:
great point , I think that Pillar already does this but its not exactly hassle
free. I have to say I really like Pillar, very simple syntax, it generates pdf
and hmtl ouput as well latex. Still will be an extra effort to bring it inside
Pharo in a form of an editor. But frankly if you want to make your own
documentation with Pillar is already very easy and the final result looks very
good.
On Fri, May 30, 2014 at 6:02 PM, Sean P. DeNigris <s...@clipperadams.com
<mailto:s...@clipperadams.com>> wrote:
kilon alios wrote
> An insane amount of documentation
<rant>
"insane" may be the key term here. We could be inventing executable active
essays, which is the kind of magic our live environment makes possible,
instead of writing and rewriting paper docs that quickly go stale.
Non-executable docs are a duplication smell and maintenance hassle.
Text-only is one of the least-effective ways to communicate. I'd love to
see
more lively kernel style docs</rant>
-----
Cheers,
Sean
--
View this message in context:
http://forum.world.st/Accessing-DLLs-in-Smalltalk-V-tp4760856p4761006.html
Sent from the Pharo Smalltalk Users mailing list archive at Nabble.com.
