Just because the thread got bumped... I kind of miss the old bucket of technical docs. They aren't user-facing, but I used it quite a lot. Perhaps instead of deleting it, move from "Learn" to "Contribute" or bury it somewhere near the bottom of the contributors' guide?
On Wed, Oct 5, 2016 at 11:21 AM James Malone <jamesmal...@google.com.invalid> wrote: > Hi all! > > I want to revive this thread if I may. Is there any way I can help on the > website redesign? Additionally, is anyone currently working on the UI/UX > design? I want to make sure I don't duplicate any work. > > Cheers! > > James > > On Tue, Aug 2, 2016 at 1:41 PM, Frances Perry <f...@google.com.invalid> > wrote: > > > Just an update for everyone... > > > > The new website navigation structure is roughly in place. However there's > > still work remaining to fill in the pages with the right content. There > are > > bugs in JIRA tracking the major gaps. > > > > In addition, JB is working on new CSS to give our site a snazzier look > ;-) > > > > On Thu, Jun 16, 2016 at 10:11 PM, Jean-Baptiste Onofré <j...@nanthrax.net> > > wrote: > > > > > Good point. It make sense to wait that it's actually implemented and > > > available before putting on the website. > > > > > > Thanks ! > > > Regards > > > JB > > > > > > > > > On 06/17/2016 07:01 AM, Frances Perry wrote: > > > > > >> 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 > > >>> > > >>> > > >> > > > -- > > > Jean-Baptiste Onofré > > > jbono...@apache.org > > > http://blog.nanthrax.net > > > Talend - http://www.talend.com > > > > > >
