<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://bugs.webkit.org/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.4.1"
          urlbase="https://bugs.webkit.org/"
          
          maintainer="admin@webkit.org"
>

    <bug>
          <bug_id>239108</bug_id>
          
          <creation_ts>2022-04-11 23:02:26 -0700</creation_ts>
          <short_desc>Add Contributing.md mentioning to how to create PR to WebKit (instead of doing it through GitHub UI)</short_desc>
          <delta_ts>2022-04-18 23:03:13 -0700</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>WebKit</product>
          <component>Tools / Tests</component>
          <version>WebKit Nightly Build</version>
          <rep_platform>Unspecified</rep_platform>
          <op_sys>Unspecified</op_sys>
          <bug_status>NEW</bug_status>
          <resolution></resolution>
          
          <see_also>https://bugs.webkit.org/show_bug.cgi?id=239082</see_also>
    
    <see_also>https://bugs.webkit.org/show_bug.cgi?id=239347</see_also>
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords>InRadar</keywords>
          <priority>P2</priority>
          <bug_severity>Normal</bug_severity>
          <target_milestone>---</target_milestone>
          
          <blocked>239082</blocked>
          <everconfirmed>1</everconfirmed>
          <reporter name="Yusuke Suzuki">ysuzuki</reporter>
          <assigned_to name="Nobody">webkit-unassigned</assigned_to>
          <cc>jbedard</cc>
    
    <cc>tetsuharu.ohzeki</cc>
    
    <cc>webkit-bug-importer</cc>
          

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>1860569</commentid>
    <comment_count>0</comment_count>
    <who name="Yusuke Suzuki">ysuzuki</who>
    <bug_when>2022-04-11 23:02:26 -0700</bug_when>
    <thetext>Contributing.md can be shown when opening PR via GitHub UI.
While we are using tools (git-webkit) to create PR with specific format, it is not easily obvious to new contributors.
Let&apos;s add Contributing.md mentioning to

1. The way to create PR through git-webkit (and introducing https://github.com/WebKit/WebKit/wiki/Contributing link)
2. Not creating a PR though GitHub UI in a normal way (just creating a branch and PR)</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>1860578</commentid>
    <comment_count>1</comment_count>
    <who name="Yusuke Suzuki">ysuzuki</who>
    <bug_when>2022-04-11 23:21:50 -0700</bug_when>
    <thetext>Some examples.

LLVM https://github.com/llvm/llvm-project/blob/main/CONTRIBUTING.md
FoundationDB https://github.com/apple/foundationdb/blob/main/CONTRIBUTING.md
Swift https://github.com/apple/swift/blob/main/CONTRIBUTING.md
Go https://github.com/golang/go/blob/master/CONTRIBUTING.md</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>1860608</commentid>
    <comment_count>2</comment_count>
    <who name="Tetsuharu Ohzeki [UTC+9]">tetsuharu.ohzeki</who>
    <bug_when>2022-04-12 00:27:47 -0700</bug_when>
    <thetext>Additionally, I think it’s better to add a PR template like https://github.com/llvm/llvm-project/blob/main/.github/PULL_REQUEST_TEMPLATE.md

I guess strongly some people will not read CONTRIBUTING.md because it’s shown as a link. But PR template fills the form to create PR.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>1860631</commentid>
    <comment_count>3</comment_count>
    <who name="Yusuke Suzuki">ysuzuki</who>
    <bug_when>2022-04-12 02:37:56 -0700</bug_when>
    <thetext>PULL_REQUEST_TEMPLATE sounds good.
We should offer the best way for contributors to access to the expected procedure so that we will not waste contributors&apos; time and their patches!</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>1861571</commentid>
    <comment_count>4</comment_count>
    <who name="Jonathan Bedard">jbedard</who>
    <bug_when>2022-04-14 10:49:29 -0700</bug_when>
    <thetext>(In reply to Yusuke Suzuki from comment #3)
&gt; PULL_REQUEST_TEMPLATE sounds good.
&gt; We should offer the best way for contributors to access to the expected
&gt; procedure so that we will not waste contributors&apos; time and their patches!

Adding the PR template in https://bugs.webkit.org/show_bug.cgi?id=239347</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>1862429</commentid>
    <comment_count>5</comment_count>
    <who name="Radar WebKit Bug Importer">webkit-bug-importer</who>
    <bug_when>2022-04-18 23:03:13 -0700</bug_when>
    <thetext>&lt;rdar://problem/91940821&gt;</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>