git: 92f5023b66 - main - Contributing to ports: encourage using git-format-patch(1) and seeking help
Li-Wen Hsu
lwhsu at FreeBSD.org
Thu Aug 19 02:36:02 UTC 2021
The branch main has been updated by lwhsu:
URL: https://cgit.FreeBSD.org/doc/commit/?id=92f5023b666d622e705c00cffebf84cf88221879
commit 92f5023b666d622e705c00cffebf84cf88221879
Author: Li-Wen Hsu <lwhsu at FreeBSD.org>
AuthorDate: 2021-08-19 02:32:28 +0000
Commit: Li-Wen Hsu <lwhsu at FreeBSD.org>
CommitDate: 2021-08-19 02:32:28 +0000
Contributing to ports: encourage using git-format-patch(1) and seeking help
Input from: Jose Luis Duran <jlduran at gmail.com>,
Pau Amma <pauamma at gundo.com>, bapt
Approved by: ygy (mentor)
Differential Revision: https://reviews.freebsd.org/D31202
---
documentation/content/en/articles/contributing/_index.adoc | 5 +++--
1 file changed, 3 insertions(+), 2 deletions(-)
diff --git a/documentation/content/en/articles/contributing/_index.adoc b/documentation/content/en/articles/contributing/_index.adoc
index 75cb38395a..7a1274a3ee 100644
--- a/documentation/content/en/articles/contributing/_index.adoc
+++ b/documentation/content/en/articles/contributing/_index.adoc
@@ -365,14 +365,15 @@ Please refer to link:{problem-reports}[Writing FreeBSD Problem Reports] for info
+
[NOTE]
======
-Please do not submit a man:shar[1] archive of the entire port; instead, use man:diff[1] `-ruN`.
+Please do not submit a man:shar[1] archive of the entire port; instead, use man:git-format-patch[1] or man:diff[1] `-ruN`.
In this way, committers can much more easily see exactly what changes are being made.
The Porter's Handbook section on link:{porters-handbook}#port-upgrading[Upgrading] has more information.
======
. Wait
+
At some stage a committer will deal with your PR.
-It may take minutes, or it may take weeks - so please be patient.
+It may take minutes, or it may take one or two weeks - so please be patient.
+If it takes any longer, please seek for help on mailing lists ({freebsd-ports}), IRC: #bsdports on EFNet or #freebsd-ports on Libera for example.
. Give feedback
+
If a committer finds a problem with your changes, they will most likely refer it back to you.
More information about the dev-commits-doc-all
mailing list