Working on a reviewer's guide for 1999.io

[scripting]

This isn't a traditional "issue" but it kind of fits.

I'm working on a new howto doc using Fargo -- it's a reviewer's guide for 1999.io.

http://reader.smallpicture.com/?opmlurl=https%3A%2F%2Fdl.dropbox.com%2Fs%2F09kyskkucmtgml9%2FreviewersGuideFor1999io.opml%3Fdl%3D0

I've started to list the most important ways to pick up the software. I wanted to be respectful to WordPress, Blogger and Tumblr, but it's important so show how 1999.io is different, and in many ways more advanced.

[akaKenSmith]

I like the reviewer's guide. Occasionally I felt it might be underplaying the strengths of the software, too mild or modest, and so I pasted it into an outliner and tried to tinker a bit, to amplify a bit. If any of the rewordings are useful, great, but if not, no harm done. I liked thinking about the software and enjoyed the chance to do it. Here is the link to the outline.

http://reader.smallpicture.com/?opmlurl=https%3A%2F%2Fdl.dropbox.com%2Fs%2Fqasdz199n6y1gt3%2Freviewdraft.opml%3Fdl%3D0

Ken

[scripting]

Ken, a reviewer's guide is not an ad.

It's an old idea back when people did software reviews. You'd provide the guide along with the product to reviewers so they knew what you wanted them to consider.

They were just suggestions, and if you hyped them, they'd trash it. And might even trash the product.

I still produce them for products, mostly so I know when I'm talking about it, these are the main points I have to hit. It's a way to get my act together.

No one needs to be sold here. That comes later, and in different contexts.

[akaKenSmith]

I see now, thanks, and since my posting goes down the wrong path, maybe it is a distraction that we should delete here?

[scripting]

No no no. It's fine. We're all friends. ;-)

[scripting]

Scott Hanson says via email that ease of installation is a major benefit.

I think he's right. So I've added a bullet item under "For programmers..."

• Quick install. Less than 5 minutes.

Dave

[akaKenSmith]

A small thing...I keep rereading that part that says "a few simple obvious steps" and I think, yes, but even that word "few" seems to make it sound harder than it is. For a basic post, type in the box and click Post. That's it. I think of an old posting, probably on Scripting News, about how many steps it takes to post something in the blogging software of a decade or more ago, and now here we are at two steps.

[Aside: until there's a blogging tool that uses telepathy will we ever see one-step posting? Maybe there could be code written that takes the first character typed as a command to post the contents of the composing box, and that would be one step blogging, but for now, two steps seems to be the natural limit and it has been reached here, happily.]

[scripting]

Ken, I agree and it's not a small thing.

It's done. Have a look.

[scotthansonde]

"No web server or database needed."

[scripting]

We cover the database stuff.

Isn't it a detail that no web server is needed?

And doesn't it raise questions if you're already running a server and want
to run 1999 behind it?

Not sure about that one.

On Sat, Jun 4, 2016 at 12:21 PM, Scott Hanson notifications@github.com
wrote:

"No web server or database needed."

—
You are receiving this because you commented.
Reply to this email directly, view it on GitHub
#27 (comment),
or mute the thread
https://github.com/notifications/unsubscribe/ABm9OzcOQAbkBXYMXZVoVjmFgytqn5NYks5qIaYCgaJpZM4Isp0M
.

[scripting]

BTW, I figured out a really nice way to incorporate screen shots.

Look at the section with the new-post stuff.

http://1999.io/about/

[scotthansonde]

OK, then leave it out. That it runs on node should be a hint about that anyway. :-)

[akaKenSmith]

That image works well there, I think, and illustrates the text above it instantly for a newcomer. Still waiting on the telepathy control system here, though.

[scripting]

I had left out any mention of the AWS version.

http://blog.1999.io/2016/05/07/0020.html

It's now included under installation bragging.

We really need an easy Docker install.

[akaKenSmith]

Maybe for newcomers say "As easy and familiar as writing a tweet or a Facebook post."

[scripting]

Ken I think that goes without saying. The words tweet and Facebook are familiar themselves.