repos / git-pr

commit

c5d9c3c

parent

69f5fd6

author

Eric Bower

date

2025-03-24 12:18:58 -0400 EDT

docs: copy

 1@@ -41,7 +41,7 @@
 2       </p>
 3 
 4       <p>
 5-        The goal is not to create another code forge here. The goal is to create a very
 6+        The goal is not to create another code forge, the goal is to create a very
 7         simple self-hosted git solution with the ability to collaborate with external
 8         contributors. All the code owner needs to setup a running git server:
 9       </p>
10@@ -57,6 +57,8 @@
11         <li>An SSH client</li>
12       </ul>
13 
14+      <div>Then everyone subscribes to our RSS feeds to receive updates to patch requests.</div>
15+
16       <h2 class="text-xl">the problem</h2>
17 
18       <p>
19@@ -253,6 +255,29 @@ git push origin main
20 
21     <pre>git format-patch main --stdout | ssh pr.pico.sh pr add {prID}</pre>
22   </details>
23+
24+  <details>
25+    <summary>How do I receive notifications?</summary>
26+
27+    <div>
28+      We have different RSS feeds depending on the use case.  This is how you
29+      can receive notifications for when someone submits or reviews patch requests.
30+    </div>
31+  </details>
32+
33+  <details>
34+    <summary>Alternative git collaboration systems</summary>
35+
36+    <div>
37+      <ol>
38+        <li><a href="https://gerritcodereview.com/">Gerrit</a></li>
39+        <li><a href="https://we.phorge.it/">Phorge</a> (fork of Phabricator)</li>
40+        <li><a href="https://graphite.dev/docs/cli-quick-start">Graphite</a></li>
41+        <li><a href="https://codeapprove.com/">CodeApprove</a></li>
42+        <li><a href="https://reviewable.io/">Reviewable</a></li>
43+      </ol>
44+    </div>
45+  </details>
46 </main>
47 
48 {{end}}

 1@@ -15,7 +15,33 @@
 2     <span>A pastebin supercharged for git collaboration</span> &middot;
 3     <a href="/docs">docs</a>
 4   </div>
 5-  <pre class="m-0">ssh {{.MetaData.URL}} help</pre>
 6+
 7+  <div class="box-sm">
 8+    <div>
 9+      Welcome to <a href="https://pico.sh">pico's</a> managed patchbin service!
10+      This is a <strong>public</strong> service that is free to anyone who wants
11+      to collaborate on git patches.  The idea is simple: submit a patchset to
12+      our service and let anyone collaborate on it by submitting follow-up patchsets.
13+      Using this service for the first time?  Creating a patch request is simple:
14+    </div>
15+
16+    <pre class="text-sm">git format-patch main --stdout | ssh pr.pico.sh pr create {repo}</pre>
17+
18+    <div>
19+      When running that command we will automatically create a user and a repo
20+      if one doesn't exist. Once the patches have been submitted you'll receive
21+      a link that you can send to a reviewer.  Anyone can review patch requests.
22+      Want to submit a v2 of the patch request?
23+    </div>
24+
25+    <pre class="text-sm">git format-patch main --stdout | ssh pr.pico.sh pr add {prID}</pre>
26+
27+    <div>
28+      Downloading a patchset is easy as well:
29+    </div>
30+
31+    <pre class="text-sm">ssh pr.pico.sh print pr-{prID}</pre>
32+  </div>
33 </header>
34 
35 <main>