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

Re: Place to put bug genie documentation.

From: Scott Rowe <scottrowe@google.com>
Date: Fri, 12 Apr 2013 10:42:19 -0700
Message-ID: <CAHZLcPqk4idmxrgt1ADwv_k-G+fJ0PMsGkMD2i3RdGOw8haAEw@mail.gmail.com>
To: Jonathan Garbee <jonathan@garbee.me>
Cc: "public-webplatform@w3.org" <public-webplatform@w3.org>
Yes, I think that makes sense. Like this?:

WPD:Contributors_Guide
    WPD:Editors_Guide
         WPD:Getting_Started
         ...
    WPD:Project_Management
         WPD:Projects
         WPD:Filing_Bugs
         ...
    WPD:Design
    ...

Then we need to revise the top-level nav, swaping "Editing" for
"Contributing," and we'll need to write our Main_Page and anywhere else
where we talk about contributing.

Am I forgetting anything?

~Scott





On Fri, Apr 12, 2013 at 9:55 AM, Jonathan Garbee <jonathan@garbee.me> wrote:

> We really need an entire section of the wiki dedicated to these docs.
> Doing it under another section such as the editors guide can get rough if
> things move around in the future.
>
> Although, seeing this and doing some thinking I think we actually need to
> move the Editors Guide around... What would probably make more sense is a
> "Contributor's Guide" then have "Editing", "Design/Skin", "Project
> Management", etc. as sub-sections of that. This way anyone wanting to
> contribute in any way can go to one place to get the information they need.
> Then under the PM section we could place the instructions on doing
> different front-end tasks related to TBG.
>
> Does a restructure like that seem reasonable to anyone else?
>
>
> On Fri, Apr 12, 2013 at 12:00 PM, Julee <julee@adobe.com> wrote:
>
>> Hi, Garbee:
>>
>> How about:
>>
>>
>> http://docs.webplatform.org/wiki/WPD:Editors_Guide/step_2_communicate_with_the_online_community#Access_the_bug-tracking_system
>>
>> Julee
>> ----------------------------
>> julee@adobe.com
>> @adobejulee
>>
>> From: Jonathan Garbee <jonathan@garbee.me>
>> Date: Friday, April 12, 2013 6:23 AM
>> To: "public-webplatform@w3.org" <public-webplatform@w3.org>
>> Subject: Place to put bug genie documentation.
>> Resent-From: <public-webplatform@w3.org>
>> Resent-Date: Friday, April 12, 2013 6:23 AM
>>
>> So, today I am finishing up the new Filing Bugs tutorial [1] with
>> pictures and all to hopefully make filing someones first issue more clear.
>> I plan on currently just tweaking the current page to hold that content.
>> Something we need to figure out though is where to place the other Bug
>> Genie documentation that is being done. I originally thought to place it
>> under WPD:TBG and have sub-pages from there on different usage tasks, but I
>> feel "TBG" doesn't make much sense unless you know what it is.
>>
>> Does anyone have any thoughts on where we should put the docs? Do
>> remember that there will really be two views in the documentation, one for
>> front-end usage and one for administrating the system.
>>
>> Thanks,
>> -Garbee
>>
>> [1] http://docs.webplatform.org/wiki/WPD:Filing_Bugs
>>
>
>
Received on Friday, 12 April 2013 17:42:47 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 19:13:45 UTC