Re: Re: Re: ePod - write easy and simple in easy-POD, convert to POD, and from there you know the way.

As I said, I have tested this with docstor, that don't know and don't want to know about syntax, nad don't have time. And the result was perfect ... The best thing is that no one needed a course about "how to write the docs", they just write and post to the site.

I don't buy it - Instead of allowing the use of descriptive formatting delimiters such as =head and =item, you replace them with shorthand symbols. The use of shorthand cryptic symbols does nothing to make POD more usable to non-programmers - If anything, this makes it less accessible to non-programmers as there needs to be an association made, which may not always be obvious, between the symbol and it's context and meaning.

If you really wanted to create a tool for non-programmers to create POD, why not create a word processor which allows for a WYSIWYG interface whilst outputting validate POD. Instead, all that you have done is create a cryptic shorthand to replace formatting directives which are already self-explanatory and straightforward.

A better name for this module might be POD::Shorthand or POD::Cryptic, but certainly not anything which suggests that this format is "easy" compared to POD.

Comment on Re: Re: Re: ePod - write easy and simple in easy-POD, convert to POD, and from there you know the way. Select or Download Code

Replies are listed 'Best First'.
Re: Re: Re: Re: ePod - write easy and simple in easy-POD, convert to POD, and from there you know the way. by gmpassos (Priest) on Jan 15, 2004 at 01:19 UTC
Yes, is also a shorthand version. And why it can't be? And I tried first to introduce POD, and doesn't work! Soo, ePod comes. Well, if you take a try you will see that ePod is not only => and >, it will also let you write the POD without care about spaces, lines and use of =over and =back for itens. For us, that write programs every day, this is silly, but try to think to some one that have only a notepad and just want to write, not code, specially write without care about rules! If you really wanted to create a tool for non-programmers to create POD, why not create a word processor which allows for a WYSIWYG interface...* Well, this is a hard job to make and maintain, since I need to make one for Palm, Windows and Linux. Also if I create a new software I need to teach them how to use it, WYSIWYG interface or not, since the last thing that they want is a new software. Soo, ePod, as POD, can be wrote in anything: notepad, pico, Word, etc... Note that ePod is not a replacement of POD! Is just a simpler way to write docs. Graciliano M. P. "Creativity is the expression of the liberty".	[reply]

Replies are listed 'Best First'.

Re: Re: Re: Re: ePod - write easy and simple in easy-POD, convert to POD, and from there you know the way.
by gmpassos (Priest) on Jan 15, 2004 at 01:19 UTC

And I tried first to introduce POD, and doesn't work! Soo, ePod comes.

Well, if you take a try you will see that ePod is not only => and *>, it will also let you write the POD without care about spaces, lines and use of =over and =back for itens. For us, that write programs every day, this is silly, but try to think to some one that have only a notepad and just want to write, not code, specially write without care about rules!

If you really wanted to create a tool for non-programmers to create POD, why not create a word processor which allows for a WYSIWYG interface...

Well, this is a hard job to make and maintain, since I need to make one for Palm, Windows and Linux. Also if I create a new software I need to teach them how to use it, WYSIWYG interface or not, since the last thing that they want is a new software. Soo, ePod, as POD, can be wrote in anything: notepad, pico, Word, etc...

Note that ePod is not a replacement of POD! Is just a simpler way to write docs.

Graciliano M. P.
"Creativity is the expression of the liberty".

[reply]