Inline... On Wed, Jun 5, 2019 at 3:28 PM St Leger, Jim <[email protected]> wrote:
> 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. > Beyond frustration. The community has been requesting for a year proper linkage to docs... and its still not done. The website hasn't been updated meaningfully since launch three year ago. Our events are multiple multiple links deep in the site. The slightest attempt to change anything involves insane efforts and high latency via staff. What we have now is simply not functional: for anyone. It's an impediment to the community, and it's not really helpful for marketing either. The fundamental issue is the extremely old fashioned way the site is maintained. > > > 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.) > All modern communities tend towards the Github+Hugo+Netlify style approach (though some are still on Jekyl) and community manage their sites. Examples: Kuberentes: https://github.com/kubernetes/website Prometheus: https://github.com/prometheus/docs Envoy: https://github.com/envoyproxy/envoyproxy.github.io OVS: https://github.com/openvswitch/openvswitch.github.io CoreDNS: https://github.com/coredns/coredns.io Containerd: https://github.com/containerd/containerd.io Fluentd: https://github.com/fluent/website GRPC: https://github.com/grpc/grpc.io Angular: https://github.com/angular/angular/tree/master/aio etcd: https://github.com/etcd-io/website Outside of LFN projects or DPDK, I am aware of few open source projects who's main website *isn't* community managed via Github+${Static generator}+{Authhoster} That said... I know for a fact that there is marketing participation in that community management of those sites... marketing contribution, review, etc. Marketing is very *valuable*. But communities generally *do* manage their own sites. I took an AI from last weeks marketing committee meeting to ask that the marketing committee get 1-2 reps (like other fd.io projects) to the process so they can participate in the review/management with the rest of the community. I think that's a very good idea, and one I hope the TSC adopts. > > > 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. > Because it's how most open source communities do it, including some of the more successful ones out there. Its the modern way of handling open source community web sites. :) > > > 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. > Yeah... I think what we've hit is "All attempts over multiple years to do it this way have failed" combined with "Most modern open source projects have had success with this Github+Hugo+Netlify approach". I think the thing we *must* do is get our marketing community plugged into the process appropriately, which hopefully we can do tomorrow :) Ed > > > Jim > > > > P.S. I’d join the discussion tomorrow, but I’ll be in a plane. > > > > *From:* [email protected] [mailto:[email protected]] *On Behalf Of *Edward > Warnicke > *Sent:* Wednesday, June 5, 2019 11:00 AM > *To:* Kinsella, Ray <[email protected]> > *Cc:* [email protected] > *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 <[email protected]> > 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:* [email protected] [mailto:[email protected]] *On Behalf Of *Edward > Warnicke > *Sent:* Thursday 30 May 2019 18:04 > *To:* [email protected] > *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 > <https://gohugo.io/>+Netlify <https://www.netlify.com/> version of the > fd.io site, which you can see here: > > > > https://myfdio.netlify.com/ > > > > 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 > <https://github.com/jadenisco/fdiomain/pull/16>). 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: > > > > https://myfdio.netlify.com/projects/ > > > > There are some mockups for vpp and CSIT, we would like all active projects > to provide content. > > > > -=-=-=-=-=-=-=-=-=-=-=- Links: You receive all messages sent to this group. View/Reply Online (#14): https://lists.fd.io/g/main/message/14 Mute This Topic: https://lists.fd.io/mt/31870906/21656 Group Owner: [email protected] Unsubscribe: https://lists.fd.io/g/main/leave/1479837/1967881053/xyzzy [[email protected]] -=-=-=-=-=-=-=-=-=-=-=-
