News for hackers. Stuff that matters.
Re:How to make a book with Pollen by chipotle_coyote on Sunday August 09, 2015 @02:41PM (#10031019)
The first sentence of the documentation tells you:

"Pollen is a publishing system that helps authors create beautiful and functional web-based books."

I think it might be good to get something like that on that introductory page, though, you're right.

Re:How to make a book with Pollen by michael_storm on Sunday August 09, 2015 @08:34PM (#10032118)
Which could be, as the GP said, a static site generator, blogging engine, ePubs, etc.

If your one-line intro for anything includes the word "system", stop and rewrite. For example:

Pollen helps authors create beautiful and functional web-based books that are written as programs that generate HTML.

Never-have-I-ever seen anything that confuses "feature" and "benefit" so much as this project. Why do I want my next book to be a program? A 20-minute video explaining it is almost condescending.

Re:How to make a book with Pollen by userbinator on Monday August 10, 2015 @12:41AM (#10032687)
If your one-line intro for anything includes the word "system", stop and rewrite.

Or "solution", for that matter; regardless of whether "enterprise" is also present.

Re:How to make a book with Pollen by Semiapies on Sunday August 09, 2015 @08:19PM (#10032060)
And when someone does that, people here complain about reading through lengthy introductions before they see any code. I presume it's a misguided attempt to satisfy such people that the book goes Installation, Quick Tour, then Backstory (before the Tutorials). In the end, it's not worthwhile to cater to this sort of "reader".