Interview Dirk from Fabriders recorded with me from earlier today. Focusing on collaboration, Book Sprints, FLOSS Manuals, and Coko.
Interview Dirk from Fabriders recorded with me from earlier today. Focusing on collaboration, Book Sprints, FLOSS Manuals, and Coko.
It’s been 10 years now since I stumbled into publishing. I started this journey after coming back from a residency in Antarctica.
On the boat back (the S.A Agulhas) I pondered what to do next.
My art career had taken me to Antarctica to build mobile autonomous bases for artist-scientist collaborations… what else could art do for me? Nothing! Time to do something else.
So, I started FLOSS Manuals – it’s still going today. A community to write free manuals about free software. It was my get rich quick scheme (hoho). From there I realised FLOSS Manuals needed more books fast and to do that I needed to come up with rapid production methodologies, production softwares, and learn how to manage and grow online communities real quick. Necessity being the mother of invention, these requirements led me to develop Book Sprints, plus innumerable book production softwares, as well as found interesting projects such as Booktype, Book.js, paged.js, pagedmedia.org, Workflow Sprints, the Cabbage Tree Method, and of course Coko (including PubSweet, XSweet, xPub, Editoria etc). As well as some interesting stops such as designing publishing systems for the UN and PLOS (Aperta) and (of course) picking up a Shuttleworth Fellowship along the way.
I didn’t make much money, but the little I did earn, I earned quick (hoho). Still… I feel pretty proud looking back. From complete novice outsider to where I am now in 10 years doesn’t feel too shoddy.
All open source too, by the way …which is also why you’ll never be able to acquire any of these technologies in the take-over sense. I slept on too many couches over the years to make this open source vision work! It ain’t for sale, but you can have it for free 🙂
So, there are a lot of product names at Coko – PubSweet, Editoria, XSweet, INK, xPub etc etc etc… so becoming tricky to track, but I wanted it seems there are quite a few people interested in xPub right now.
xPub is not really a product as such, it’s more a group of products – each of which relates to Journal workflows. The names for each product indicyae those relationships: xpub-collabra, xpub-elife, xpub-faraday (Hindawi) and xpub-epmc
Each of these is a platform, so yip, you read it right – there are actually no less than 4 journal platforms being developed in the Coko community, not including the Micropublications platforms (of which there are two – one developed with Wormbase, and the other with the Organisation for Human Brain Mapping).
So, right from the get go our ‘offer’ is not standard. We don’t offer one platform to rule them all – there are many journal platforms in production. All of these are built on top of PubSweet… PubSweet is a kind of ‘headless’ publishing platform….it’s more or less the backend brains in that it is a kind of framework that ‘thinks like a publishing system’ but has not determined a workflow for you. So, each of the xpub-* platforms are actually publishing platforms built to meet a specific workflow and built on top of PubSweet…
Here is a crappy diagram (drawn in haste) to get the basic idea across:
In the above, you see a PubSweet platform (eg. xpub-elife). PubSweet itself is the whole app – it sort of ‘encapsulates’ everything. Really though, you get the PubSweet core and then extend it with front-end components to meet your workflow needs. A typical front-end component might be a login screen, or a dash, a submission info page, a reviewer form etc.
You can also extend PubSweet on the back end as well (eg to enable integration with external services etc). The following is a more accurate but slightly techy architectural overview (you can skip this image and the following paragraph if you want to avoid the slightly techie part of this article).
So each PubSweet platform has its own collection of front and back end components to meet the workflow of someone’s dreams… the idea is that to achieve the platform of your dreams you can reuse what others have already built and then just build what isn’t already available. In a sense, you can ‘assemble’ your platform from existing parts.
The nice thing about this is that each of the organisations building Journal platforms are sharing the following:
Each organisation has a vision of their ideal Journal workflow. They then design and build this on top of PubSweet, but as they do, they build various components (either page-based components such as a dashboard, or smaller UI components we call atoms and molecules) and they share these components with everyone. Hence, you should check the list of components before you start building in case the component you need already exists.
We have various agreed-upon ways to build and share components (see this as an example). These best practices are continuously evolving but you can read some of the latest discussions about this approach here – https://gitlab.coko.foundation/pubsweet/pubsweet/issues/408
Of course, all code is reusable in the Coko community because it’s all open source. The best practices are there to make the code easy to reuse.
All agreements as per above are made by consensus by the community. It is actually a pretty snappy process – don’t believe every crappy thing you read about how open source is built. Open source community processes can be elegant and fast, and the resulting code can beautiful. Coko is a good example of this – a community of professionals collaborating together to make fantastic open source software.
So… back to the xPub story. To make these decisions on how to share components etc, we have regular meetings with various workgroups (we keep the numbers in each group small so we can move fast), and we also have quite a few in-person meetings. Not only do we have PubSweet community meetings where all of these organisations meet, but we have various get-togethers on various topics if required. For example, we met in Cambridge recently to discuss Libero (the eLife delivery product), before that EBI there was an onboarding session in Athens, next month we have a special designers workgroup in-person meet, anbd so on. All this helps us keep in contact with each other, which helps build trust, but also turns out to lift energy levels and boost production. These meetings are fun.
Also at these meetings, we learn from each other. One of the big problems in this sector, and one of the reasons people ask ‘why are publishing platforms so hard to build?‘ (after a number of high profile failures), is that there has not been a focused effort to share experiences on how to build publishing platforms. So, that is what we are doing – at each meeting we talk about what we have learned, how we are thinking about things, and show each other what we have done. The last meeting, for example, each xPub platform gave a deep dive to everyone in the group in a process known as speed geeking (it wasn’t so speedy as each table had 25-30 mins to go through their platform).
So, xPub isn’t a single platform, it’s more the community that is building journal platforms on top of PubSweet and sharing learnings and components. It is a very cool thing.
As a community, we also produced a book entitled ‘PubSweet – how to build a publishing platform’. You can get this for free here – https://coko.foundation/books/
I can also send you a print copy (they look great!) if you send me a postal address.
The book covers many things – a whole lot of technical documentation for how to build and share components etc, as well as some information about to think about workflow and how to map this into a PubSweet system. Personally, I don’t think the technology is very hard when it comes to building platforms – we knew what we wanted from the beginning with PubSweet and went about and built it (not to downplay the extraordinary job Jure Triglav has done in leading this effort). But the real hard stuff is actually thinking about workflow – not many publishing orgs have had the opportunity to think about designing their workflow to meet exactly what they want (rather than shoe-horning it into an existing system), and so we have had to beat this track for other to follow. It has been quite a journey but the book pretty effectively outlines how to think about workflow (which of course is a process that can be accelerated using Workflow Sprints which is a process I designed to facilitate a publisher to design their own workflow and PubSweet platform in one day).
In that book you can see some high level ‘architectures’ of each of the xPub platforms such as the following (xpub-collabora):
Or this (xpub-epmc):
So, you might be asking…. at what stage of development are each of these platforms? … I’ll leave it to each of the teams to say exactly, but it has been shocking to see how fast things have come along. I mean, the xPub community only really got together for the first time mid-last year, and building started for most late last year and early this year. It looks like we will have a lot of platforms landing by the end of this year. In this sector that is lightning fast. EBI are particularly impressive – they started two months ago and are almost ready to go – if it weren’t for the fact we are all replacing the under-the-hood data model we designed together at the last PubSweet meet, they would be good to go already. They can achieve such speed because they are reusing a lot of the components that the other teams built before them (and because EBI are just very good 🙂 ).
I can speak a little more about xpub-collabra since that is the platform Coko is building for and with the Collabra Psychology Journal. It’s looking pretty nice. We have some work tidying up the UI, replacing the data model and a few other things, but it’s looking rather good. We are also putting some time into making it a generic platform since the Collabra workflow follows a fairly ‘plain vanilla’ model. So we are building in some management interfaces and various bits and pieces to make it more widely useful – for example, Giannis just built in a Submission Info builder – enabling a Journal admin to build their own submission forms. It requires some hand-holding to use right now, but we’ll shape it to be very usable by your general journal adminy-type. We also have to integrate ORCID and DOIs, extend the range of submission file types etc… but it’s pretty close.
Below is a video showing xpub-collabra in action. It is a a version from some months ago, but you can see the workflow pretty well in this demo.
I think most of the xpub community is going to offer their new platforms to the market in various ways. This will be interesting as there are very different approaches at play. Hindawi, for example, is looking to make their platform a multi-tenant platform, eLife will put JATS at the centre of the workflow etc… So look for more news on that also. For our part, Coko will offer xPub through a partnership with a hosting provider – probably with the same organisations we will work with for Editoria hosting services. Since everything we do is open source, we will also be supplying all the Docker, Helm and Kubernetes scripts so that you can set up your own commercial hosting service if that is your cup of tea (or you can extend your offering should you already be a hosting provider). Coko is pretty close to getting our first hosting partnership set up, so look for news of that soon!
One last thing – because of the modular nature of any platform built on top of PubSweet, it is possible to take any of the xPub platforms and customise it to meet your needs. No need to start building from zero. Additionally, the modularity means you can extend the systems with your own interesting new innovation – finally a place for innovation to call home in the publishing platform world….
So… there is a lot going on in the xPub world….we look quite different to the rest of the market because we are not building one platform – we have instead focused on building a community to support the development of multiple platform solutions for journal workflows. You can pick and choose which one you want, or build something else, reusing as much of the other systems as you can to reduce your development costs (we also spend a lot of time onboarding new folks and supporting them as much as we can).
But it’s not just about improving the game today – supporting the optimisation of workflows is one part of what we are trying to do, the other is to support future innovations.
If you want to know more, feel free to jump into the Coko community channel and chat – https://mattermost.coko.foundation
Come and join the party. We are happy to support you and happy to learn from you…. not-for-profit or commercial we don’t care, build a better journal platform on PubSweet than the rest of us and we’d be happy! We are in it for the mission – come to talk to us! no preciousness here 🙂
So.. recently, as in – yesterday – there was some news that Elsevier are acquiring Aries. Aries makes the closed source Manuscript Submission System – Editorial Manager.
Elsevier is like the Death Star in the Journal world… I mean, so many in the academic and scholarly publishing worlds despise Elsevier that it is actually a little shocking to hear them talk about it.
Aries is also not very well liked either since they have produced a pretty terrible software for managing journals. It is expensive and painful to use. Despite ridiculous assertions that it is a ‘best of class’ system:
Elsevier to Acquire Aries Systems, A Best-in-class Publication Workflow Solutions Provider https://t.co/fVkbUjTXxr
— Kent Anderson (@kanderson) August 2, 2018
Not many publishers would agree with that! It is a thoroughly unimaginative and misguided assertion ripped straight out of the Aries Press Release – https://www.ariessys.com/views-press/news-opinion/elsevier-acquire-aries-systems-best-class-publication-workflow-solutions-provider/
So, the coupling of the two seems to be quite an event, especially since many Journals, the ones that don’t like Elsevier, have their content hosted in Editorial Manager. Seems like the worst of the worst situation for those folks.
Which is exactly what our good friend Alison Mudditt must have been feeling (we worked with Alison when she was at UCP) when she posted the following:
Believe me, this has not been great news to wake up to. But we’ve had this news for less than an hour so need to digest before commenting further.
— Alison Mudditt (@alison_mudditt) August 2, 2018
At Coko, we have been telling people since day one that publishing infrastructure should be open source because one day you will wake up and you just don’t know who will now own the keys to your workflow and content kingdoms…
These things are not hard to predict… if you want to make some money as a seer, just pick a popular closed source platform and say out loud ‘I predict one day they will make decisions that are not in your best interests’… recently I said this about Medium and Github, as well as Editorial Manager…
Our postponed online discussion with @CokoFoundation’s Adam Hyde, has finally got a new date! Tune in at August 6th at 9:00 PDT. We’ll be talking collaborative content creation I’ll be reminding him about that Microsoft GitHub Acquisition prediction. RSVP: https://t.co/GkGvFPDChb pic.twitter.com/ogA1ZrUeHv
— Dirk Slater (@FabRider) July 31, 2018
…and what do you know… yes, astonishing, I must have the best crystal ball ever!…. sigh…. predicting the future has never been so easy. Sadly this kind of makes predicting the future a tragic business to be in. It’s like a reverse boy-who-cried-wolf situation – what happens when you cry wolf but everyone stays in bed, and the wolf shows up and eats a villager – every time? What do you do with that?
It is apparent Aries did not have their clients’ best interests at heart – they know the feeling the sector has about Elsevier… and for many, many publishers this will be seen as a breach of trust. Bad luck for their clients that are now feeling very uncomfortable and wondering what Aries has landed them in.
So, if I might make another prediction – I think this recent acquisition is going to be awesome. Awesome because it may finally be a wake-up moment for publishers, a reminder that they should own their own infrastructure and not be beholden to organisations that do not have their best interests at heart.
For those feeling disorientated right now and wondering what to do… come talk to us, and join the growing movement to replace the current proprietary publishing tools with an open source publishing infrastructure. We are happy to help!
Just been in Athens, hanging out with the Coko Athens crew – Yannis, Christos, Giannis and Alexis. A thoroughly good bunch.
I think before I’ve mentioned how proud I am to work with them and what we are achieving. I mean, it’s a teamof 4 people and together they are developing 3 publishing platforms and a sophisticated web-based word processor … essentially 4 platforms – Editoria, xpub (Journals), micropubs, and Wax (editor)… I mean… talk about punching above your weight! More than that, we have fun doing it.
Every month I come to Athens and we discuss the coming month’s roadmaps. I come for a few days, we drink a lot of Freddo Espresso and sometimes (at the other end of the day) some margaritas. In between, we order some iffy delivery food and plan the future.
The roadmapping sessions involve us going through each platform together, and looking at last month’s roadmap. Discuss the next priorities and approaches, and then commit those to the next month’s roadmap for that project. It’s pretty interesting and super great to have everyone involved in the process. We get a good wide range of opinions and at the same time give everyone ownership of their own project. This is what collaboration is all about.
So some short notes here on this month’s roadmapping…
Wax – We have come very close to a fully functional web-based word processor based on the Substance libs. It is looking amazing with support for the normal editor stuff – headings, images, bold etc – plus some amazingly sophisticated features including track changes, notes management (more complex than it sounds), thread-based commenting/annotations, diacritics support … and a lot more… However, we have decided to start building a new Wax based on the ProseMirror libs, mainly because there is a lack of community around the substance.io libraries and we wish to de-risk ourselves going forward. So we’ll finish off Wax 1.0 with a Substance upgrade which will also bring us table support, nested lists, and some other issues. At the same time we will continue developing the new Wax (we already have something basic working) – first by adding some interesting widgets that the ProseMirror community have built, and then by building a simple plugin structure for editor widgets. We split Wax roadmaps up, but the important stuff for the current wax is listed in the Editoria repo – https://gitlab.coko.foundation/editoria/editoria#roadmap
xpub – we are now fixing a few bugs in the journal system and moving forward with migrating to the new shared data model that was collaboratively designed at the recent PubSweet meeting in Cambridge (UK). This will include some initial research into GraphQL (part and parcel of the migration). Part-way through August, Giannis is attending the Libero workshop at eLife and will work on that with the eLife team for 2 weeks. Libero is the open source web-delivery part of the publishing cycle that eLife has designed and is about to build. So we want to put into that effort and learn what we can. That also means the actual migration to the new data model will happen after those 2 weeks ie. We’ll start it on Sept 1. More info here – https://gitlab.coko.foundation/xpub/xpub#roadmap
Editoria – this is coming along fast. Alexis just added EPUB export and overhauled the workflow management tool. Editoria is pretty much ‘fully fledged’ although we have many ideas for new features – however much of this will wait until the Editoria community meeting in San Francisco in October. In the meantime, we are being good open source citizens and writing a lot of under-the-hood tests. Alexis will also spend a day or so writing a new Authsome mode to match the Book Sprints workflow to show that the auth app Jure (PubSweet lead dev) built is indeed plug-and-play. More info here – https://gitlab.coko.foundation/editoria/editoria#roadmap
Micropubs – we are developing a micropublications platform with the Wormbase crew. Its early days but ison schedule with the first thin slice. It contains complex integrations and complex submission forms. But Yannis is making good speed, so more of the same! https://gitlab.coko.foundation/micropubs/wormbase#roadmap
It is, as I said above, an awesome team. I’m very proud of what we are achieving together and I like to punch above our weight. Much more information coming soon about all of this as we go!
Spending a night tomorrow in the UK, and then to San Francisco for a meet with Kristen, attending FOO camp and many other bits n pieces.
So, I’ve been pursuing this dream for many years… every since I started rendering books in the browser using an ad-hoc collection of tools around 10 years ago…. then I instigated the book.js project (which unfortunately died due to lack of browser support of CSS Regions), and now… paged.js…
Built by the talented trio of Julie Blanc, Fred Chasen and Julien Taquet – it’s all open source and modular… there is a lot to this story, but we’ll get to that. Full release in a few weeks, this is a sneak peak:
This project is entirely funded by the awesome Shuttleworth Foundation.