Locked Re: Community management of main fd.io website


St Leger, Jim <jim.st.leger@...>
 

Ed/Ray/FD.io Community:

 

I haven’t been directly involved in this discussion.  But my observations are that there is an effort in FD.io to improve some of the content and documentation (which is always commendable) but also some level of frustration with how to get that content updated and published on the website and/or wiki pages.

 

My past experience both here and in other projects has me conclude:

- Use a marketing team for the “pretty” public facing content. This would be all the fd.io facing material.  FD.io has a marketing committee that should own and drive that effort.  They should also be working with the broader LFN marketing advisory committee for support, ideas, etc.

- Use the technical community for technical content that predominantly shows up on the wiki, developer targeted pages.  If req’d the FD.io TSC could ask the LFN TAC for help (though I don’t suspect that’s needed.)

 

I don’t know why we’d ever want to get the communities technical experts working on non-wiki tech pages.  And if there’s some gaps wrt support from the marketing team then perhaps the topic should be brought up there and addressed head-on.

 

Hope this perspective helps a bit. Let me know what “we already tried that” or other barriers exist. Then let’s get the right folks to step up, own them, and resolve them. Our tech experts can then focus on creating the best technical documentation and not worry about website layout, etc.

 

Jim

 

P.S. I’d join the discussion tomorrow, but I’ll be in a plane.

 

From: main@... [mailto:main@...] On Behalf Of Edward Warnicke
Sent: Wednesday, June 5, 2019 11:00 AM
To: Kinsella, Ray <ray.kinsella@...>
Cc: main@...
Subject: Re: [FD.io] Community management of main fd.io website

 

Totally.  There was some discussion after you left about whether to take a vote or wait a week.  The consensus was that you had seemed very supportive, and so we felt comfortable proceeding.

Our intention was not to preclude any further discussion you think might be productive.  Lets talk about it tomorrow :)

 

Ed

 

On Wed, Jun 5, 2019 at 12:13 PM Kinsella, Ray <ray.kinsella@...> wrote:

Hi Ed,

 

Looks like this vote occurred after I left the call, so I missed it.

 

I very much want to commend the work that John DeNisco in particular has done here, it is really impressive.

John has been working tirelessly on the FD.io documentation and the website since this time last year, he deserves a lot of recognition for this.

 

However I think this bears a little further discussion at the TSC.

For instance, I understand that this will make technical contributors such as PTL’s lives easier.

I am 100% on that page, however do we have input from the FD.io marketing committee on the change?

What happens to Linux Foundation marketing support after this change is made?

 

Could we schedule it as an agenda item tomorrow?

 

Thanks,

 

Ray K

 

From: main@... [mailto:main@...] On Behalf Of Edward Warnicke
Sent: Thursday 30 May 2019 18:04
To: main@...
Subject: [FD.io] Community management of main fd.io website

 

In todays FD.io TSC meeting, the TSC voted to take steps to allow the FD.io community to manage the main fd.io website.

 

As part of the discussion, John DeNisco showed off a Github+Hugo+Netlify version of the fd.io site, which you can see here:

 

 

It is driven by PRs to a github repo.  The repo for the above demo is:

 

https://github.com/jadenisco/fdiomain if you want to take a look at how it works.

 

We will be moving this to fdio/site in Github as part of this process.

 

Anyone can push a PR to alter the website (example).  The PRs generate preview site that can be examined prior to merge.  Deployment of merged content to the main site is automatic.

 

The other thing the TSC decided today was to ask the PTL of each project to propose 1-2 representatives to get access to review site changes in Github and have access to the Netlify org.

 

So PTLs, please respond to this email indicating your nominees for those roles.  Please cc them so I have emails to use to invite them to various things.  Bonus points if you can include their Github ids :)

 

In particular there is a place for each project to list content about themselves here:

 

 

There are some mockups for vpp and CSIT, we would like all active projects to provide content.

Join main@lists.fd.io to automatically receive all group messages.