Rolling Birthday…

I had a rolling birthday over a few weeks. Covering NZ and Berlin, maybe soon birthday drinks in SF….First was  bbq at my place in NZ with the neighbors and Nokome, Jure and Yannis… then dinner with Ma and some old family buddies, and then drinks in Berlin… It was cool for me to see people from different parts of my life hanging together. some photos…

dsc04828

dsc04833

dsc04838

dsc04844

dsc04856

dsc05187

dsc05189

dsc05197

dsc05200

img_0573

p1010457

p1010458

p1010459

p1010462

Pondering Editors

Editors are a hard problem. I don’t mean editors-the people… although that might also be true 😉 … I mean the technology you use to write and edit WYSIWHAT?documents. Its tough stuff. Over the years I’ve bet on several of them starting when I first replaced the native wiki-markup editor in TWiki with TinyMCE… and then later CKEditor…and so on with FLOSS Manuals..

The point with editors is that they are like racehorses… you put your money on the best one available at the time. They will win for a while, but no horse lasts forever.

After I abandoned TWiki and we started building Booki, which was later to become Booktype, I brought a bunch of people together in Berlin at an event called WYSIWHAT? to choose the best horse. Which is funny to me, looking back at it, as I had forgotten that over the years I’ve been involved in trying to build community around several different editors.

imag0618

I had gone into the WYSIWHAT meet thinking it might be the Mercury Editor which was an extremely innovative editor at the time… but the community chose Aloha Editor (see also Kathi Fletcher’s notes from the meeting). So we built that into Booktype. Aloha has since been left behind, although at the time it was the right choice. Funny thing is with these things I still hear people saying “jeez…you chose Aloha, and it wasn’t the best choice”…well… big news… it was the right choice a the time but if you haven’t looked at a clock lately then you might need to be reminded that times change… I wouldn’t pick Aloha today, nor would I pick TinyMCE… you got to go with what is the best choice at the moment.

Then, I chose the Wikipedia Visual Editor for the Tahi/Aperta project. Which was complex, but the right choice at the time.

So, through this history, I have learned some stuff… In my mind, there are several things to consider when choosing an editor, or the underlying libs for building an editor (which is what we are doing now with the Wax editor at Coko). Essentially they come down to:

  1. will itdo what you want it to do technically?
  2. is there good documentation?
  3. is there good community?

It goes without saying that I am talking only about Open Source options. And, just to point out the obvious, with closed source options you might do well on (2) above for user (but not API) documentation, but fail on 1 (because you can’t see the code) and 3 (because closed source isn’t about a development community).

Anyways… now we are somewhat down the road with what we are doing at Coko, we know a lot more about community and why it’s important. For that reason, the above would have once been my order of priority a few years ago, but today it looks more like this:

  1. is there good community?
  2. will it do what you want it to do technically?
  3. is there good documentation?

You can go a long way with community support if the tech isn’t quite there – either with help to work out ways to do things in ways you hadn’t considered, or by eventually getting features you need into the core code. In essence, a good community plays a supporting role (as a good community member you should reciprocate) and a good community listens to what it is that you need…

Although docs are very important, and every project should have them, a functioning community can also help a great deal if the docs are lacking.

That’s not to say that the ideal solution doesn’t check all the boxes (community, tech, docs)… just to say that an open source project with community ranks miles above one without. It is going to be more fun and get you where you need to get quicker. Also, and perhaps most importantly, an open source project with community is substantially less risk for you going forward. The more active the community the less chance the project will die if any one individual decides to leave or change direction.

So… back to the races…

Two new PagedMedia Posts

One from Nellie McKesson on her awesome new project Hederis.

https://www.pagedmedia.org/introducing-hederis-and-why-we-care-so-much-about-pagination/

And another from Erich van Rijn about Editoria and pagination.

https://www.pagedmedia.org/editoria-building-a-book-in-a-browser/

Wandering again

Off to London today for the 3rd PubSweet meet. 3 days of joyous banter about all things PubSweet. This meeting will mainly be a work meet with eLife/YLD, Coko, Collabra, and Hindawi/Thin Slices. We are also onboarding some potential new partners.

Then I’ll be on the road to Berlin to talk hosting and have a birthday drink. I’ll also catch up with the Book Sprint folks.

Then its San Francisco for a couple of weeks! Tally Ho!