New Foundation Microsite

[mikeal]

Heya,

It has been a bit problematic having some of the foundation content on the regular website because the contribution flow is a bit too developer specific for people from marketing and PR to edit the content. Examples of this content are:

• Press Releases (currently https://nodejs.org/en/foundation/announcements/)
• "In the News" articles (currently https://nodejs.org/en/foundation/in-the-news/ which is a JS load in from a spreadsheet to workaround this)
• Member List which needs to be updated in lock step with new member announcements (https://nodejs.org/en/foundation/members/)

There's also new content coming up like case studies that need a place to go.

I've spent a lot of time trying to find an editor or some kind of workflow that makes it usable to create and edit content on the regular website but there just isn't. There's a few good markdown editors but the yaml metadata at the top of pages is a pretty difficult hill to climb.

Ideally we would keep the contribution flow for design, structure and hosting to be friendly to the developer community but with an integrated content editor that is usable by non-programmers.

Enter KeystoneJS http://keystonejs.com/ , which is the best CMS I can find written in Node.js :)

The marketing and PR people have tested out the demo and find it suitable and it's also relatively simple for developers to edit structure and design.

@nodejs/build will need to verify that we can easily host and auto-deploy this.

[ghostbar]

Is there no way to adapt prose.io? http://prose.io/#about https://github.com/prose/prose

The metadata looks pretty much like what jekyll uses and that's handled already by prose.

[mikeal]

@ghostbar the problem isn't just editing the metadata, it's that there's a bunch of boilerplate metadata that you need to understand in order to add any content. I tried to get prose to work, I tried all of the markdown editors, and it just isn't a good flow, especially for editing content.

[williamkapke]

@mikeal I'm concerned that putting the content in Mongo (via KeystoneJS or whatever) with a system that needs logins doesn't offer a place for the community to iterate/collaborate on the content before and after publishing.

...maybe, in this case, the Foundation content is solely owned and controlled by Marketing/PR..?

[Starefossen]

I am curious how the Marketing and PR people at the Foundation fits in with the open and collaborative efforts put forward by the Evangelism and Website working groups? Will the foundation take over all responsibilities for publishing content on the nodejs.org website in the future?

[mikeal]

@williamkapke ya, this content is primarily, if not entirely, created and edited by marketing/PR, who currently can't collaborate in the existing website (to date I've had to do almost all the writing and edits myself).

@Starefossen So, for the last 6 months both Evangelism and Marketing/PR have been working in an independent but complimentary way. Evangelism posts to the Node.js blog (they actually create more content than Marketing/PR) and routinely gives the @nodejs tweets to publish and promote.

We've actually already separated the voices somewhat. The Project/Community has the main blog voice and Marketing/Industry voice is on a Medium blog. The place this gets mixed up is the Press Releases that end up in the main blog, and that's only because when we give that to press it needs to a nodejs.org address on it. I would like to clean this up because when the project tells people they need to install a security update it means more than the marketing voice telling them the same thing.

But, to be clear, nothing Evangelism is doing now will be taken on by Marketing/PR. These will remain parallel and complimentary efforts.

Also, the work here is separated but we've actually been working to bridge the communication between Evangelism and Marketing/PR. Julian was invited to participate in the Marketing Committee in order to bring in a perspective from Evangelism and i18n.

[jbergstroem]

@mikeal quick q: searched for a marketing team but couldn't find any members? https://github.com/orgs/nodejs/teams?utf8=✓&query=marketing. Is this separate from github?

[mikeal]

@jbergstroem A few of them have GitHub accounts but mostly aren't on GitHub :) These are people employed by the Linux Foundation to do this work for the Node.js Foundation in coordination with the Marketing Committee (which is a foundation member committee).

[rvagg]

/cc @JedWatson who is behind KeystoneJS.

I'm concerned that the Build team may not have the stomach to administer or be responsible for a Mongo deployment but reckon that we might be able to find a mutually beneficial arrangement with Jed & Keystone, either by their contributing to the Build team to help shoulder responsibility or perhaps even taking that load entirely. It'd be good for Keystone (I have no problem with a "powered by Keystone" FWIW) and the usability is absolutely a problem for non-technical people that we need to fix.

[JedWatson]

Enter KeystoneJS http://keystonejs.com, which is the best CMS I can find written in Node.js :)

Thanks @mikeal! Stoked to hear that.

👍 Just had a quick chat with the team at Thinkmill, would love to take this on. We're happy to support the deployment and help make sure things go smoothly. Also on board for design / development if that helps.

FWIW we're also embarking on a project to implement database adapters in Keystone (to remove the hard dependency on MongoDB) and are looking initially at Postgres and RethingDB. No promises on timing but we can look at the Mongo deployment as a short-term thing. We also have production systems replicating to Postgres by tailing the oplog, in place for analytics, which has been quite successful and means anything we do won't be locked into the Mongo platform.

[mikeal]

The whole setup will end up behind Cloudflare so we could use a remotely hosted MongoDB if there is a reasonable hosting service. Any performance issues we might be worried about are probably negligible given it'll be behind a cache.

[JedWatson]

We generally use https://mlab.com for hosting with servers at AWS

[williamkapke]

+1 on mlab (prev known as MongoLab). I've had great success with them... even with their FREE version. They been handling a ton of Tinder's load.

[wonderdogone]

mlab will work if it's def going to be mongo. What about the host? I using Digital Ocean for some smaller (and budget conscious) projects/ They do have nice API's to work with.

[mikeal]

@wonderdogone the build group has donated compute resources across several providers, including digitalocean.

[mikeal]

Created a new repo https://github.com/nodejs/foundation.nodejs.org

I signed up for mlab for the foundation, I can share the credentials with the build team.

@JedWatson the site.css doesn't seem to be loading, wondering what the deal is there.