Commit Graph

97 Commits

Author SHA1 Message Date
Sergio Carlavilla Delgado 0d9894b11e Improve the SEO of the documentation portal
Changes:
- Add the description meta tag in the index, articles and books
- Add a brief description in each article and book.
- Remove the SVN expansion tag
2021-05-02 00:54:35 +02:00
Oskar Holmlund e633f0b9df Add committers entries for Oskar Holmlund (oh)
Step 7.1.[1-4] in committers guide.

Reviewed by: manu, br, delphij
Approved by: manu (mentor)
Differential Revision: https://reviews.freebsd.org/D29996
2021-04-30 14:12:09 +02:00
Dimitry Andric 14874cd74d Fix minor typo: s/Exteral/External/. 2021-04-28 20:29:18 +02:00
Mathieu Arnold a6e878928c
Add a first quick and dirty draft of what Git can do with GnuPG.
Reviewed by:	rene, imp, lwhsu
Differential Revision:	https://reviews.freebsd.org/D29726
2021-04-27 08:16:49 +02:00
Mathieu Arnold fb18f59114
Add a short section about commit message for ports.
Reviewed by:	bapt
Differential Revision:	https://reviews.freebsd.org/D29994
2021-04-27 08:14:40 +02:00
Mateusz Piotrowski 18298aec36 committers-guide: Remove confusing line
It is unclear what this line is referring to. Remove it.
2021-04-26 22:46:09 +02:00
Mateusz Piotrowski 6e8e66005b committers-guide: Do not use google as a verb 2021-04-26 22:40:03 +02:00
Mateusz Piotrowski 77e05e5b5c committers-guide: Merge duplicate policies into one
Those two points describe the same situation. Merge them into one point.
2021-04-26 22:36:33 +02:00
Mateusz Piotrowski 70d4e0e799 committers-guide: Update list of files all committers may modify
The paths have changed after the switch to Git.
2021-04-26 22:34:26 +02:00
Mateusz Piotrowski 656d6eccb7 committers-guide: Clean up commit bit types description
There is no need to mention explicitly that src committers may commit to
the doc tree if they receive an appropriate approval. That's true for
all the other committer types and trees.
2021-04-26 22:34:26 +02:00
Ceri Davies cdc25df8de articles/committers-guide: fix typo 2021-04-26 14:18:49 -04:00
Warner Losh b9c2beb17b committer-guide: master->main rename in an example or two
These instances of master or freebsd/master which should really be
main. I did these examples against the old github mirror.

Sponsored by:		Netflix
2021-04-26 10:20:16 -06:00
Fernando Apesteguía a30982fef8 [committers-guide] Remove obsolete misc question
Adding files in Git does not requiere special considerations.

Approved by: 0mp
Differential Revision: https://reviews.freebsd.org/D29884
2021-04-22 08:28:34 +02:00
Fernando Apesteguía 0eb1ef29d9 [committers-guide] Fix typo
s/relese/release

Approved by: 0mp
Differential Revision: https://reviews.freebsd.org/D29889
2021-04-22 08:24:48 +02:00
Fernando Apesteguía 69fe0eea04 [committers-guide] Consistent use of Subversion
Majority of the uses capitalize the first letter. Let the rest do the same.

Approved by: 0mp
Differential Revision: https://reviews.freebsd.org/D29888
2021-04-22 08:22:52 +02:00
Fernando Apesteguía 8f3c366fd2 [committers-guide] Update src branches information
Summary:
s/SVN/Git
s/head/main

Although there are other branches in the repo (like vendor/ or releng/), if they
were not considered noteworthy before, I choose not make them notheworthy now.

Test Plan: * Renders OK.

Reviewers: 0mp, gbe

Differential Revision: https://reviews.freebsd.org/D29886
2021-04-21 18:39:58 +02:00
Mateusz Piotrowski 5755cad0f0 committers-guide: Fix indentation of commit message examples 2021-04-20 17:45:54 +02:00
Mateusz Piotrowski bcd1bb7a20 committers-guide: Remove "Submitted by" from examples
Reviewed by:	imp
Differential Revision:	https://reviews.freebsd.org/D29868
2021-04-20 17:45:19 +02:00
Mateusz Piotrowski ea68d93d5f committers-guide: Discourage use of Submitted by
The use of "Submitted by" is discouraged in all the source trees now.
2021-04-20 17:11:49 +02:00
Mateusz Piotrowski a527f32556 committers-guide: Bring back MFH metadata field
The MFH field is still useful to note that the commit is going to be
merged into a quarterly branch.

Reported by:	mat
Reviewed by:	mat
Differential Revision: https://reviews.freebsd.org/D29862
2021-04-20 14:56:44 +02:00
Mateusz Piotrowski ceee1def00 articles/committers-guide: Document change in MFH policy
Merging commits into the quarterly branch no longer requires an explicit
approval [1]. Let's remove outdated documentation and leave a note
explaining that there is no need for an explicit approval to MFH.

 [1] https://svnweb.freebsd.org/ports?view=revision&revision=556626
2021-04-20 12:14:58 +02:00
Mateusz Piotrowski 32abed26b2 articles/committers-guide: Update "MFC with" description
We use Git hashes now, not revision numbers.
2021-04-20 11:58:39 +02:00
Li-Wen Hsu 6d2a97cf80
Fix path: s,/usr/local/shared,/usr/local/share,
PR:		255101
Reported by:	Christos Margiolis <christos@christosmarg.xyz>
Approved by:	carlavilla (implicitly)
2021-04-20 12:21:23 +08:00
Mark Johnston 6f71dc766b Clarify that the vendor merge commits should have proper commit messages
Reviewed by:	imp
Differential Revision:	https://reviews.freebsd.org/D29745
2021-04-19 15:54:02 -04:00
Mateusz Piotrowski e233d63695 Use sysrc instead of echo to modify rc.conf 2021-04-19 11:32:41 +02:00
Fernando Apesteguía 745eae659f articles/committers-guide: fix README link
Current link in Committer's Guide for the README of the addkeys.sh script is
broken.

It should point to https://docs.freebsd.org/pgpkeys/README.

Approved by: 0mp (mentor)
Differential Revision: https://reviews.freebsd.org/D28928
2021-04-18 19:48:22 +02:00
Fernando Apesteguía f54d697cc3 [Committers Guide] Fix paths in Steps for New Committers
* There is no authors.toml but authors.adoc

* Add `doc` in the path as in the other steps to make explicit that we refer
  to the `doc` repository.

* s/shared/share in `src` repository:

Approved by: 0mp (mentor)
Differential Revision: https://reviews.freebsd.org/D28590
2021-04-18 17:48:14 +02:00
Danilo G. Baio 2644b2cda8 articles/contributing: Update ports resources
Add a note that portsmon is currently not working, more visibility to
portscout and add new resource portsfallout.

Approved by:	debdrup (doc)
Differential Revision:	https://reviews.freebsd.org/D29715
2021-04-17 18:25:45 -03:00
Mateusz Piotrowski a1bee259bb Provide a one-liner for the "Fixes" commit key word 2021-04-17 21:43:23 +02:00
Mateusz Piotrowski 84d56d3868 Capitalize words properly
I've capitalized "git" throughout the document where appropriate.
There are also some other words I've fixed like "github" and "gitlab",
but I've not reviewed the whole document looking for those.
2021-04-17 21:33:58 +02:00
Ryusuke SUZUKI dc2b9671b7 Correct the cgit repository URL for ports tree. 2021-04-17 11:42:53 +09:00
Mateusz Piotrowski e2e3e51b70 Do not recommend filling "Fixes:" with SVN revisions
The ports tree has transitioned to Git already.
2021-04-16 02:30:59 +02:00
Muhammad Moinur Rahman 9ad828a6e5 Add rsync.net percs in FreeBSD Committer's Guide 2021-04-12 20:04:23 +00:00
Muhammad Moinur Rahman 43635078c3 Move araujo@ ed@ and jpaetzel@ from committers to alumni after their
bits have been safe kept.
Approved by:	core (with core-secretary@ hats on)
Differential Revision:	https://reviews.freebsd.org/D29705
2021-04-11 19:02:24 +00:00
Marc Fonvieille 05b8a96ab7 Fix a typo and some word tagging. 2021-04-11 14:03:33 +02:00
Marc Fonvieille f86e96e387 Add missing whitespace and correct tagging to one command. 2021-04-11 13:54:17 +02:00
Fernando Apesteguía 0a8625aacc [committers-guide] Add missing word
In section 5.8 Collaborating with others.

Approved by: gbe
Differential Revision: https://reviews.freebsd.org/D29693
2021-04-10 21:18:58 +02:00
George V. Neville-Neil a0fbda3eef Rough draft on collaboration using github 2021-04-09 16:17:49 -04:00
George V. Neville-Neil 63584c7bba Address points brought up by bsdimp 2021-04-09 16:17:49 -04:00
George V. Neville-Neil 6982d9119d Add langauge and other simple updates from uqs 2021-04-09 16:17:49 -04:00
George V. Neville-Neil e47e964a9d Rough draft on collaboration using github 2021-04-09 16:17:49 -04:00
Muhammad Moinur Rahman 2c1a6b3977 Add OpenSMTPD example for sending mail through FreeBSD mxs
Adds an example on howto configure OpenSMPTD to forward
locally sent mails to FreeBSD.org mail servers.

Approved by:	crees, imp
Differential Revision:	https://reviews.freebsd.org/D29574
2021-04-06 20:54:18 +00:00
Warner Losh 4011c596fd Remove the subversion section from the committer's guide.
FreeBSD committers no longer need to know how to use subversion.
Remove the subversion primer from the committer's guide.
Add a VCS history section.

Suggestions by:		lwhsu@
Differential Revision:  https://reviews.freebsd.org/D29610
2021-04-06 13:45:16 -06:00
Rene Ladan c9b990e272 Committers Guide: fix some URLs and mention our GitHub mirror.
Submitted by:	lwhsu
2021-04-06 21:43:36 +02:00
Rene Ladan 7792f7607a Update some links and branch names in the Problem Report article.
Reviewed by:	emaste
Differential Revision:	https://reviews.freebsd.org/D29450
2021-04-06 20:54:52 +02:00
Rene Ladan 3c9ef247f5 Committers Guide: update the ports-specific sections to git.
- Remove notes that the migration is in progress
- Remove old branch names and URLs
- Remove mention of psvn
- Remove section about re-adding a deleted port, git add will do the
  right thingn natively (most of the times).
- Remove section about repo-copies, git has no copy command.
- Simplify instructions for moving a port.
- Remove section about the mfh tool. Merges are now just cherry-picks.

Reviewed by:	crees, emaste, imp, lwhsu, mat
Differential Revision:	https://reviews.freebsd.org/D29450
2021-04-06 20:53:12 +02:00
Chris Rees 6e35f5def2 Sort(ish) and add a couple of years from CVS logs 2021-03-29 22:13:03 +01:00
Rene Ladan acc10bbdad problem-reports: convert a svnweb link for UPDATING to cgit.
# Uncomment and complete these metadata fields, as appropriate:
#
# PR:
# Submitted by:
# Reported by:
# Reviewed by:
# Approved by:
# Obtained from:
# MFC after:
# MFH:
# Relnotes:
# Security:
# Sponsored by:
# Pull Request:
# Differential Revision:
#
# Description of fields to fill in above:                 72 columns --|
# PR:                       If and which Problem Report is related.
# Submitted by:             If someone else sent in the change.
# Reported by:              If someone else reported the issue.
# Reviewed by:              If someone else reviewed your modification.
# Approved by:              If you needed approval for this commit.
# Obtained from:            If the change is from a third party.
# MFC after:                N [day[s]|week[s]|month[s]].  Request a reminder email.
# MFH:                      Ports tree branch name.  Request approval for merge.
# Relnotes:                 Set to 'yes' for mention in release notes.
# Security:                 Vulnerability reference (one per line) or description.
# Sponsored by:             If the change was sponsored by an organization.
# Pull Request:             https://github.com/freebsd/<repo>/pull/### (*full* GitHub URL needed).
# Differential Revision:    https://reviews.freebsd.org/D### (*full* phabric URL needed).
2021-03-29 21:47:58 +02:00
Chris Rees fa297bffcf Sort 2021-03-29 16:36:20 +01:00
Chris Rees f6a81bf544 Add Simon Peter for sysutils/fluxengine
PR:	ports/254586
2021-03-29 16:04:15 +01:00