I left couple comments on the PR. On Thu, Nov 1, 2018 at 12:44 PM Alan Myrvold <amyrv...@google.com> wrote:
> I like that change, especially providing all the resources in one spot. > > http://apache-beam-website-pull-requests.storage.googleapis.com/6912/contribute/get-help/index.html > > On Thu, Nov 1, 2018 at 11:13 AM Kenneth Knowles <k...@google.com> wrote: > >> To make it concrete and not just critique, I put together >> https://github.com/apache/beam/pull/6912 for consideration. >> >> Kenn >> >> On Thu, Nov 1, 2018 at 10:48 AM Kenneth Knowles <k...@google.com> wrote: >> >>> I can accept (but never love) a sidebar that isn't a site map. >>> Personally, I find them disorienting and they lower my confidence in the >>> quality and authoritativeness of the content. But I understand I am just >>> one person, composed of idiosyncracies. >>> >>> I actually think that the contents of Community > Contact Us are not >>> contextualized for an incoming contributor. How about "Contribute > Get >>> Help": a page more focused on contributors, clarifying the role of >>> different communication channels and the PMC/Committers roster for getting >>> a change build and incorporated. It could also subsume the off-site FAQ >>> link. >>> >>> Kenn >>> >>> On Thu, Nov 1, 2018 at 10:16 AM Scott Wegner <sc...@apache.org> wrote: >>> >>>> In the case of "Contact Us", the redundancy is deliberate-- we received >>>> feedback on the Contribution Guide that the content is heavy and it wasn't >>>> obvious how to find help. We wanted the "Contact Us" link as visible as >>>> possible, so the proposed solution was to have it in both sidebars. >>>> >>>> In my opinion I don't think a strict content hierarchy is necessary in >>>> the sidebar, and we should instead focus on providing the right context. >>>> We'll hit additional cases like this as more content moves out to the wiki. >>>> >>>> Some additional details on the original feedback is in JIRA: >>>> https://issues.apache.org/jira/browse/BEAM-5735 >>>> >>>> On Thu, Nov 1, 2018 at 10:02 AM Kenneth Knowles <k...@google.com> wrote: >>>> >>>>> And the site map structure actually has a couple more issues: >>>>> >>>>> - Contribute > Roadmap is the same as top-level Roadmap >>>>> - Contribute > Contact Us is the same as Community > Contact Us. >>>>> - Contribute > PMC and Committers is the same as Community > Team >>>>> - Contribute > Policies > * is separate from Community > Policies, >>>>> for good reasons but it looks weird >>>>> >>>>> I don't mean this only as a critique of the change, but also of the >>>>> prior structure, which seemingly didn't work well. >>>>> >>>>> Sam/Thomas/Scott also - was it the case that while working through >>>>> contributing it was unclear where these resources could be found? Is there >>>>> a better division here? I think previously the Contribute and Community >>>>> sections were one and the same, but we split them to put more heavyweight >>>>> stuff under Contribute. >>>>> >>>>> Kenn >>>>> >>>> >>>> >>>> -- >>>> >>>> >>>> >>>> >>>> Got feedback? tinyurl.com/swegner-feedback >>>> >>>