Good thoughts. There'll be a section on IO that comes over as part of the programming guide being ported from the Cloud Dataflow docs. Hopefully that has the technical info needed. Once we see how that's structured (Devin is still playing around with a single page or multiple), then we can decide if we need to make it more visible. Maybe we should add a summary table to the overview page too?
As for DSLs, I think it remains to be seen how we tightly we choose to integrate them into Beam. As we've started discussing before, we may decide that some of them belong elsewhere because they change the user-visible concepts, but should be discoverable from our documentation. Or others may more closely align and just expose subsets. But in any case -- totally agree we should add the right concepts when we cross that bridge. On Thu, Jun 16, 2016 at 9:53 PM, Jean-Baptiste Onofré <j...@nanthrax.net> wrote: > Hi Frances, > > great doc ! > > Maybe in the "Learn" section, we can also add IOs (like SDKs, and > runners), like we do in Camel (http://camel.apache.org/components.html) > For the SDKs, I would also add DSLs in the same section. > > WDYT ? > > Regards > JB > > > On 06/17/2016 12:21 AM, Frances Perry wrote: > >> Good point, JB -- let's redo the page layout as well. >> >> I started with your proposal and tweaked it a bit to add in more details >> and divide things a bit more according to use case (end user vs. >> runner/sdk >> developer): >> >> https://docs.google.com/document/d/1-0jMv7NnYp0Ttt4voulUMwVe_qjBYeNMLm2LusYF3gQ/edit >> >> Let me know what you think, and what part you'd like to drive! I'd suggest >> we get the new section layout set this week, so we can parallelize site >> design and assorted page content. >> >> On Mon, Jun 6, 2016 at 8:38 AM, Jean-Baptiste Onofré <j...@nanthrax.net> >> wrote: >> >> Hi James, >>> >>> very good idea ! >>> >>> Couple of month ago, I completely revamped the Karaf website: >>> >>> http://karaf.apache.org/ >>> >>> It could be a good skeleton in term of sections/pages. >>> >>> IMHO, for Beam, at least for the home page, we should have: >>> 1. a clear message about what Beam is from an user perspective: why >>> should >>> I use Beam and write pipelines, what's the value, etc. The runner >>> writers, >>> or DSL writers will find their resources but not on the homepage (on >>> dedicated section of the website). >>> >>> In term of sections, we could propose >>> 1.1. Overview (with the three perspective/type of users) >>> 1.2. Libraries: SDKs, DSLs, IOs, Runners >>> 1.3. Documentation: Dev Guide, Samples, Runners Writer guide, ... >>> 1.4. Community: mailing list, contribution guide, ... >>> 1.5. Apache (link to ASF) >>> >>> 2. a look'n feel should be clean and professional, at least for the home >>> page. >>> >>> I would love to help here ! >>> >>> Regards >>> JB >>> >>> >>> On 06/06/2016 05:29 PM, James Malone wrote: >>> >>> Hello everyone! >>>> >>>> The current design of the Apache Beam website[1] is based on the a basic >>>> Bootstrap/Jekyll theme. While this made getting an initial site out >>>> quickly >>>> pretty easy, the site itself is a little bland (in my opinion :). I >>>> propose >>>> we create a new design (layout templates, color schemes, visual design) >>>> for >>>> the Beam website. >>>> >>>> Since the website is currently using Bootstrap and Jekyll, this should >>>> be >>>> a >>>> relatively easy process. Getting this done will require a new design and >>>> some CSS/HTML work. Additionally, before a design is put in place, I >>>> think >>>> it makes sense to discuss any ideas about a future design first. >>>> >>>> So, I think there are two open questions behind this proposal: >>>> >>>> 1. Is there anyone within the community who would be interested in >>>> creating >>>> a design proposal or two and sharing them with the community? >>>> 2. Are there any ideas, opinions, and thoughts around what the design of >>>> the site *should* be? >>>> >>>> What does everyone think? >>>> >>>> Cheers! >>>> >>>> James >>>> >>>> [1]: http://beam.incubator.apache.org >>>> >>>> >>>> -- >>> Jean-Baptiste Onofré >>> jbono...@apache.org >>> http://blog.nanthrax.net >>> Talend - http://www.talend.com >>> >>> >> > -- > Jean-Baptiste Onofré > jbono...@apache.org > http://blog.nanthrax.net > Talend - http://www.talend.com >
