W3C home > Mailing lists > Public > public-webplatform@w3.org > March 2013

Re: Getting Started page updated

From: Doug May <intuedge@gmail.com>
Date: Thu, 28 Mar 2013 11:18:57 -0700
Message-ID: <CABPs60EJJQS_a6tWhvchg3ig1RJcqiAzAir82vsKQ7BYwzq6cA@mail.gmail.com>
To: Sébastien Desbenoit <seb@desbenoit.net>
Cc: Scott Rowe <scottrowe@google.com>, Julee Burdekin <jburdeki@adobe.com>, Eliot Graff <Eliot.Graff@microsoft.com>, "public-webplatform@w3.org" <public-webplatform@w3.org>
The getting started page, as brilliant and as majorly improved as it
is, still has two main problems:

One, it's too long.  Probably best fixed by splitting out the 3 types
of work effort onto 3 separate pages.  It would be great to have some
kind of side-by-side comparison of the skills and tasks involved, to
see each level at a glance, but having that much content just stacked
vertically in one long page means that most of the page won't apply to
me (whichever level I choose), and I can easily find myself
inadvertently jumping from one set of instructions to another (they
all look the same).

Secondly, it's still a central part of the highly non-smooth new user
flow -- it sends people away, for an indeterminate set of "getting set
up" tasks, right at the top -- and last I checked there was no clear
return path.  Maybe this page is "selecting the right tasks and
challenges to take on" and it is referenced by the new "getting
started" page.

DougM

On Wed, Mar 27, 2013 at 11:48 PM, Sébastien Desbenoit <seb@desbenoit.net> wrote:
> Hi Scott,
>
> Indeed, this page should stay very simple, it just needs a color on title
> and perhaps a horizontal bar to guide the looks of our user.
>
> Seb
>
> Le 27 mars 2013 à 16:45, Scott Rowe <scottrowe@google.com> a écrit :
>
> Thanks all! I appreciate the kudos.
>
> With this page, I followed the Teddy Roosevelt postulate: "Start where you
> are, use what you've got, do what you can." So, yeah, there's no new
> styling. If anyone wants to doll it up a bit, please do.
>
> The one provision I would like to maintain is that we keep this page simple.
> I struggle daily with the notion that our pages are too cluttered and hard
> to read versus the realization that, dammit, it's a documentation site and
> visitors have to RTFM(!). With the Getting Started page, the objective is to
> provide a list of pages to work on, broken down by task type. I've tried to
> keep verbiage to a minimum, leaving most of the instructions to the Editor's
> Guide.
>
> Any styling that moves this page forward (ahem) would be great. By the way,
> though, I'm not a huge fan of the movethewebforward design - a bit too
> blocky and monochromatic for my taste. But I do appreciate the way the
> layout follows a "simple to complex" degradation of the information, and
> that's what I've tried to achieve with the Getting Started page.
>
> ~Scott
>
>
>
> On Tue, Mar 26, 2013 at 10:58 PM, Sébastien Desbenoit <seb@desbenoit.net>
> wrote:
>>
>> It's awesome!
>>
>> Maybe the three tittle and the boxes need a bit more style to be
>> identified at the first look, I may be a bit dump, but I had a "very" quick
>> look and I didn't see any change. I say the layout after my second visit:
>> after looking at move the web forward. Maybe some space or a horizontal bar.
>> I don't know. In my opinion, it's a bit too linear but it's just a style
>> thing, the architecture is awesome.
>>
>> Seb
>>
>>
>> Le 27 mars 2013 à 02:18, Julee Burdekin <jburdeki@adobe.com> a écrit :
>>
>> +flippin'1 ! Thanks, Scott, fr0zenice and Paul Rosenbusch!! J
>>
>>
>> ----------------------------
>> julee@adobe.com
>> @adobejulee
>>
>> From: Eliot Graff <Eliot.Graff@microsoft.com>
>> Date: Tuesday, March 26, 2013 3:03 PM
>> To: Scott Rowe <scottrowe@google.com>, "public-webplatform@w3.org"
>> <public-webplatform@w3.org>
>> Subject: RE: Getting Started page updated
>> Resent-From: <public-webplatform@w3.org>
>> Resent-Date: Tuesday, March 26, 2013 3:04 PM
>>
>> That is flippin’ BEAUTIFUL!
>>
>> Thanks, Scott (and those who created the query template).
>>
>> Eliot
>>
>> From: Scott Rowe [mailto:scottrowe@google.com]
>> Sent: Tuesday, March 26, 2013 11:02 AM
>> To: public-webplatform@w3.org
>> Subject: Getting Started page updated
>>
>> Using fr0zenice and Paul Rosenbusch's nifty Configurable_Query template,
>> I've updated the Getting Started page [1], replacing the previous links to
>> old-school query results pages with the Page/Summary tables produced by the
>> Configurable_Query.
>>
>> The new design breaks tasks out according to three levels, basic,
>> involved, and advanced. Of the involved tasks, some are also broken out by
>> domain (CSS, API, etc.)
>>
>> This design gets its inspiration from the Move the Web Forward [2] layout,
>> which presents visitors with increasing levels of involvement as they scroll
>> down the page.
>>
>> We anticipate a need to introduce the WPD Projects with more information
>> under the Advanced task section, and as the Project project evolves, we can
>> fill in this information.
>>
>> The next item on my list is writing up how to use the Configurable_Query
>> template for contributors. If you want to start using these right away, you
>> can steal mine from my User:Scottrowe page [3]. Just copy the entire page
>> into your own like-named page.
>>
>> Cheers!
>> ~Scott
>>
>>
>> [1] http://docs.webplatform.org/wiki/WPD:Getting_Started
>> [2] http://movethewebforward.org/
>> [3] http://docs.webplatform.org/wiki/User:Scottrowe/pages/custom_list
>>
>>
>>
>>
>>
>>
>>
>>
>> --
>> Sébastien Desbenoit
>>  -
>> http://notes.desbenoit.net -
>> http://internetetmoi.fr
>>
>
>
> --
> Sébastien Desbenoit
>  -
> http://notes.desbenoit.net -
> http://internetetmoi.fr
>
Received on Thursday, 28 March 2013 18:19:26 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 8 May 2013 19:57:41 UTC