openwhisk-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From edoardo g <egm3...@gmail.com>
Subject Re: OpenWhisk.org content and updates
Date Wed, 01 Feb 2017 21:42:12 GMT
please unsubscribe

Il 01/Feb/2017 21:41, "Daniel Krook" <krook@us.ibm.com> ha scritto:

>
>
> Hello all,
>
> I was part of the team that put together the content for OpenWhisk.org last
> year. This email has some details on the audiences that it is meant to
> serve as well as details on how updates are handled.
>
> The primary two goals right now are to develop a site that A) adheres to
> the Incubator Graduation requirements [1] and B) accelerates ecosystem
> formation around Apache OpenWhisk.
>
> *Target users for OpenWhisk.org*
> There are a few general audiences we identified last year, which we call
> "personas":
>
> 1. The end user, a serverless function developer writing code that runs on
> a provided OpenWhisk instance
> 2. The open source project contributor building the underlying platform
> through Apache (or engineer/student that wants to learn how it works under
> the hood)
> 3. The third party service integrator building packages that provide
> triggers and feeds that they want to share with others.
>
> The operator deploying OpenWhisk clusters might overlap with those 3 roles,
> but may be also a fourth target persona to address specifically. There may
> also be additional personas to consider as we go forward.
>
> So with many different user types - and materials that may be of interest
> across personas - it makes sense to have one single site (rather than split
> into different sites by audience type, i.e., distinct developer and user
> sites on different domains).
>
> *Immediate todos*
> The current site centers around making it easy for each of those personas
> to get started with OpenWhisk and includes general interest information on
> serverless technology and the Apache project. It also links to the social
> media channels and mailing lists as a one-stop-shop for those new to
> OpenWhisk to find the specific resource they need for their role.
>
> We have solid guidelines and many existing sites to reference as we improve
> the site to address the two primary goals. There is guidance from the
> Incubator [1], and precedents like Apache Cordova [2], Apache CouchDB [3],
> and Apache Groovy [4] among others.  Jason Lengstorf pulled together a good
> list of suggestions to improve the site in an issue on GitHub [5] based on
> what works for other open source projects. There is also an issue open to
> address the current "partners" page and transform it into a "supporters"
> page, based on the earlier threads here [6].
>
> You can see the complete list of open issues on GitHub [7] which is where
> we directly link and track changes completed or proposed for the site.
>
> *Managing updates*
> As Apache Groovy does [8], we'd like to have
> http://openwhisk.incubator.apache.org redirect to http://openwhisk.org.
> The
> name servers for for openwhisk.org are mapped to the GitHub repository [9]
> which serves content out of the master branch using GitHub Pages.
>
> Currently, content is automatically published to http://openwhisk.org when
> pull requests are merged into master by an approved Committer. Those pull
> requests are tied to issues. When pull requests are merged, the issue(s)
> are automatically closed if the PR comment includes the phrase "closes
> issue #XXX". We can have both issues and PRs post to email and Slack.
> Because of this simple deployment process, it doesn't seem that we'd want
> to change the current process or require any sort of new build
> infrastructure be put in place.
>
> *Summary*
> As mentioned above, the end goal is a site that adheres to the Incubator
> Graduation requirements and accelerates ecosystem formation around Apache
> OpenWhisk. Please comment on this approach with your thoughts or
> suggestions so that we can achieve these goals as effectively as possible.
>
>
> [1] http://incubator.apache.org/guides/sites.html
> [2] https://cordova.apache.org/
> [3] http://couchdb.apache.org/
> [4] http://groovy-lang.org/
> [5] https://github.com/openwhisk/openwhisk.github.io/issues/123
> [6] https://github.com/openwhisk/openwhisk.github.io/issues/158
> [7] https://github.com/openwhisk/openwhisk.github.io/issues
> [8] http://groovy.apache.org
> [9] https://github.com/openwhisk/openwhisk.github.io
>
>
>
>
> Daniel Krook
> http://krook.info/
>

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message