aboutsummaryrefslogtreecommitdiff
path: root/documentation/content/en/articles
Commit message (Collapse)AuthorAgeFilesLines
...
* Committer's guide: Remove email sender specificationLorenzo Salvadore2023-04-071-1/+1
| | | | | | | | | Do not specify anymore that the email granting a commit bit is from core, since such emails are not sent by core for ports and doc commit bits: they are only for src. Approved by: carlavilla (mentor) Differential Revision: https://reviews.freebsd.org/D39447
* committers-guide: minor improvements to the EnglishCeri Davies2023-04-061-3/+3
|
* Committer's Guide … Git … MFC … Examples: noneGraham Perrin2023-04-021-2/+0
| | | | | | | | | | | | | | The 'Examples' subheading that is currently at https://docs.freebsd.org/en/articles/committers-guide/#_examples has no subtext. Hiding the subheading was considered. Instead, it is deleted. https://bugs.freebsd.org/264080 PR: 264080 Approved by: imp Differential Revision: https://reviews.freebsd.org/D39384
* git-primer: Update how to rebase a vender branch mergeWarner Losh2023-03-311-36/+63
| | | | | | | | | | | | | | | Update the vendor branch merge section to include the missing commands and hopefully to make it more clear. Switch to using bogus branch names that will stand out on purpose. This rework 'play' tested on the lua branch merge, which needed dozens of rebasing... Also, indent by one space the conflict section so as to not confuse automated tools (or me) that it's a real conflict that needs to be resolved. Sponsored by: Netflix
* committers guide: remove "MFC with" tagEd Maste2023-03-212-9/+0
| | | | | | | | "Fixes" and "MFC with" are used for approximately the same purpose, but the former is standard in the Git-based deveopment world. Reviewed by: jhb Differential Revision: https://reviews.freebsd.org/D39190
* Committer guide: Correct the pacakge names of GCC12 for cross compilingLi-Wen Hsu2023-03-191-3/+3
| | | | | | | | Use the newly added syntax of the pacakge macro (in 1d899c1c6fc6). While here, fix some wording and typo spotted by Pau Amma. Differential Revision: https://reviews.freebsd.org/D39068
* freebsd-status-report-process: Fix in "Submit your report"Lorenzo Salvadore2023-03-141-1/+1
| | | | | | | Reports should be put "in the appropriate subdirectory" not "in the directory in the appropriate subdirectory". Approved by: doceng (blanket)
* freebsd-status-report-process: Add articleLorenzo Salvadore2023-03-091-0/+288
| | | | | | | | | | | | Add a new article about the FreeBSD status report process created by putting together content from - website/content/en/status/_index.adoc; - website/content/en/status/README (file is now removed); - website/content/en/status/howto/_index.adoc (file is now removed). Reviewed by: status (pauamma) Approved by: doc (bcr) Differential Revision: https://reviews.freebsd.org/D38919
* Trademarks: Add Git, GitHub and GitLabLorenzo Salvadore2023-03-051-2/+2
| | | | | | | | | | | | | | | | | | | | | - Git: add the trademark line suggested by https://git-scm.com/about/trademark - GitLab: add the trademark line requested by https://about.gitlab.com/handbook/marketing/brand-and-product-marketing/brand/brand-activation/trademark-guidelines/ - GitHub: it is a registered trademark according to the following links: https://github.com/logos https://docs.github.com/en/site-policy/github-terms/github-open-source-applications-terms-and-conditions#githubs-logos https://tmsearch.uspto.gov/bin/showfield?f=doc&state=4808:xvjz5y.2.4 Apply the newly introduced trademarks to the Committer's guide. Also add a TM symbol immediately after the first reference to the GitLab Name as requested by https://about.gitlab.com/handbook/marketing/brand-and-product-marketing/brand/brand-activation/trademark-guidelines/ Approved by: doceng (carlavilla) Differential Revision: https://reviews.freebsd.org/D38916
* committers-guide: spell checksCeri Davies2023-03-051-7/+7
|
* Add my PGP keyMikhail Pchelin2023-03-021-0/+3
|
* committers-guide: Add section on range of compilersWarner Losh2023-02-281-1/+61
| | | | | | | | | Document the range of compilers the project uses for building, CI and external toolchain support, and try to assign the proper level of effort developers should go to for each of them. Sponsored by: Netflix Differential Revision: https://reviews.freebsd.org/D38709
* New committer (src): Cheng Cui (cc)Cheng Cui2023-02-261-0/+3
| | | | | | | | | | Summary: Complete steps 1-4 from Committer's Guide section 7.1. Reviewers: rscheff, tuexen Reviewed By: rscheff, tuexen Differential Revision: https://reviews.freebsd.org/D38797
* Contributors to FreeBSD: more relevance and appealGraham Perrin2023-02-261-68/+72
| | | | | | | | | | | Don't begin the article with the one and only section that is (much) more than twelve years out of date. Move the Donors gallery to the end. Improve it a little – not forgetting a link out to The FreeBSD Foundation. Approved by: doc (pauamma, carlavilla) Differential revision: https://reviews.freebsd.org/D38796
* doc: linux-users: Fix extref to the updating chapter in handbookMateusz Piotrowski2023-02-231-1/+1
|
* doc: linux-users: Note that root shell is sh in FreeBSD and laterMateusz Piotrowski2023-02-231-1/+2
|
* git-primer: Trim old subversion infoWarner Losh2023-02-211-394/+4
| | | | | | | | It's been a couple of years since we transitioned to git. Remove this transition information. Should people really need it, it will be in the doc git repo history. Make minor tweaks to some adjacent material. Sponsored by: Netflix
* tiers: Remove obsolete languageWarner Losh2023-02-211-4/+0
| | | | | | | | amd64 is none of these things, so just remove the 'justifcation' sentence. It's wrong and fixing it wouldn't add any value. Sponsored by: Netflix Differential Revision: https://reviews.freebsd.org/D38708
* articles: Fix LSP JSON compilation database filenameKa Ho Ng2023-02-122-6/+6
| | | | Approved by: lwhsu (docs)
* contributing: Start pointing people at githubWarner Losh2023-02-111-0/+23
| | | | | | | | | | | Start pointing people to submitting github pull requests for simple changes. Provide some guidance on what is a simple change. This is a continuation of earlier experiments with the best way to process patches. Sponsored by: Netflix Reviewed by: debdrup, brooks, allanjude Differential Revision: https://reviews.freebsd.org/D38382
* Very belatedly add my PGP keyJason A. Harmening2023-02-101-0/+3
|
* New committer (ports): Robert Nagy (rnagy)Robert Nagy2023-02-091-0/+3
| | | | | | Completed steps 1-4 from Committer's Guide. Approved by: rene (mentor)
* pgpkeys: add key for fuzRobert Clausecker2023-02-081-0/+3
| | | | | | | | | Onboard new ports committer Robert Clausecker (fuz) in accordance with step 4 of sec. 7.1 committer's guide Approved by: eduardo (mentor) See also: D38417 (step 5) Differential Revision: https://reviews.freebsd.org/D38416
* git primer: Fix two errorsWarner Losh2023-01-291-8/+1
| | | | | | | | | | | | | Recommend pushing HEAD:main in the vendor branch docs, since that's always going to be right. Stop recommending people set push.default to 'freebsd'. It's an enumerated value that's not a branch name. Most likely correct value here is 'upstream'. However, there's enough people with asymetrical setups that I'm just removing the setup rather than describe all the special cases. Sponsored by: Netflix
* git primer: Fix push commandWarner Losh2023-01-281-1/+1
| | | | | | | | | The instructions leave one on the merge_results branch, not on main, so pushing the remote repo won't work. You have to specifically add the branch name on the push for that to work. Noticed by: sjg Sponsored by: Netflix
* Add pkg install clarification to FreeBSD src lsp articleDerik2023-01-281-6/+25
| | | | PR: 269137
* license-guide: correct some typos/grammarCeri Davies2023-01-261-9/+9
|
* doc: Update source files (en .po), for translationsDanilo G. Baio2023-01-213-1090/+1116
|
* Remove the secteam-secretary key and any references to it.Gordon Tetlow2023-01-061-3/+0
| | | | Approved by: so
* Miscellaneous small changes to the Committer's Guide.Pau Amma2023-01-031-20/+28
| | | | | | | | | | | PR below plus a few more I spotted while working on it. While there, check nearby URLs still work and use https:. PR: https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=261812 Reviewed by: carlavlla, gjb, philip Approved by: carlavilla (mentor), gjb (mentor, earlier version) Differential Revision: https://reviews.freebsd.org/D37091
* license: Move to BSD-2-Clause and drop -FreeBSDWarner Losh2022-12-151-1/+1
| | | | | | | | | | | | | BSD-2-Clause-FreeBSD has been deprecated as a separate license. https://tools.spdx.org/app/check_license/ says that the text matches BSD-2-Cluase. There's some history behind the mismatch, but it's best to move forward now that our preferred license matches BSD-2-Clause. Sponsored by: Netflix Reviewed by: pauamma, andrew Differential Revision: https://reviews.freebsd.org/D37714
* license-guide: Copy editWarner Losh2022-11-081-24/+26
| | | | | | | | | | Various suggestions to improve the grammar, spelling and clarity of the document. Suggested by: pauamma (with changes by me) Reviewed by: pauamma Sponsored by: Netflix Differential Revision: https://reviews.freebsd.org/D37304
* Add cust_pkgng to NanoBSDSergio Carlavilla Delgado2022-11-061-0/+1
| | | | | | PR: 230642 Patch by: <f.toscan@hotmail.it> and converted to AsciiDoc by carlavilla@
* license: Create a license guideline documentWarner Losh2022-11-051-0/+327
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Create a license guideline document for the project. This pulls together all the disparate docs into one location. This does not (yet) remove the content from the other locations. Also, introduce a new policy to allow SPDX identifiers to completely specify a license and specify the mechanics of how to construe the license for such files. This policy should be viewed as nearly complete in spirit, but not yet finalized in wording. Ongoing legal review will result in at least editorial changes. Note 1: This changes the wording of our default license slightly in a way that the SPDX legal team has deemed to be not legally different as a practical matter in jurisdictions where Linux is relevant. Note 2: This changes the default preferred license to detached, though still allows the non-detached version. Note 3: Text of the licenses is not (yet) in the src tree. That will happend on the road to final approval. I have one IP lawyer setup to review this, and invitations out to a few more that specialize in the unique considerations that "open source IP" and "open source projects" present (turns out they are hard to find and often quite busy). Together, all these people should provide world-wide coverage and may result in tweaks to account for variation in IP legal regulatory regimes. Once this review is complete, I'll remove the 'other' copies of this information and pending final core approval it will become the policy of the project. Getting it committed will elevate its visibility and help me to get legal reviews more easily. Prior core teams have approved this in spirit. The current core team will have final approval once I've worked out the final rounds of feedback. Approved in theory: core.10 and core.11 Discussed with: emaste, brooks, jhb, gnn Sponsored by: Netflix Differential Revision: https://reviews.freebsd.org/D29543
* New committer (src): Corvin Köhne (corvink)Corvin Köhne2022-11-031-0/+3
| | | | | | | Follow step 4 of the committer's guide. Approved by: manu (mentor) Differential Revision: https://reviews.freebsd.org/D37245
* New committer (src): Zhenlei Huang (zlei)Zhenlei Huang2022-11-021-0/+3
| | | | | | | | Follow steps 1-4 of the Committer's Guide. Reviewed by: carlavilla, kp Approved by: carlavilla, kp (mentor) Differential Revision: https://reviews.freebsd.org/D37131
* doc: Update source files (en .po), for translationsDanilo G. Baio2022-10-302-87/+103
|
* articles/problem-reports: cease recommending the 'patch' keywordGraham Perrin2022-10-291-1/+3
| | | | | | | | | | | | | | | | | | | | | | | | | | 'Writing FreeBSD Problem Reports' pleads for use of a keyword: patch – https://docs.freebsd.org/en/articles/problem-reports/#pr-writing-tips Keywords 'patch' and 'patch-ready' remain in Bugzilla – https://bugs.freebsd.org/bugzilla/describekeywords.cgi – but should no longer be used. Both keywords are deprecated: https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=227147 Update the article: * end the plea * explain why the available keywords should not be used. PR: 267176 Bug report: https://bugs.freebsd.org/267176 Mentors: gjb, carlavilla Reviewed by: gjb Approved by: gjb Differential revision: https://reviews.freebsd.org/D37086
* Add back meta's keyKoichiro Iwao2022-10-281-0/+3
|
* Add records about new ports committer (ronald)Ronald Klop2022-10-201-0/+3
| | | | | | | New author entry for Ronald Klop together with the news item and PGP key added. List of Developers and Contributors updated as well to follow steps 1-4 of the Committers Guide. Approved by: rene (mentor) Differential Revision: https://reviews.freebsd.org/D37065
* doc: Update source files (en .po), for translationsDanilo G. Baio2022-10-163-8/+43
|
* handbooks: Remove references to portsnapMuhammad Moinur Rahman2022-10-091-4/+4
| | | | | | | | | | | | | | | | Although we are still generating portsnap deltas it is no longer the recommended methods and git should be promoted. So remove references to portsnap. Additionally - Remove training whitespace - Remove trailing consecutive blank lines By no means this is an indication that portsnap is going to be removed from the base or that portmgr@ is going to stop producing deltas. This is just to demote the usages of portsnap and promote git. PR: 264763 Approved by: carlavilla (mentor)
* Add JetBrains to the committers perksMuhammad Moinur Rahman2022-10-091-10/+22
| | | | | | | | | | | JetBrains is offering 100 licenses yearly for FreeBSD committers. Add it to the Committer's Guide as perks. - Remove trailing whitespaces - Remove trailing blank lines PR: 264764 Approved by: carlavilla (mentor)
* Properly fix things.Fernando Apesteguía2022-10-071-1/+1
|
* [articles/pgpkeys] Fix doceng secretary reference.Fernando Apesteguía2022-10-071-1/+1
| | | | Use name + email address as in the other cases.
* doc: Update source files (en .po), for translationsDanilo G. Baio2022-10-012-1021/+1026
|
* [doc-en][articles/committers-guide] Fix subsectionFernando Apesteguía2022-09-301-0/+1
| | | | | | Add a blank line after "====" subsection. The English version is rendered well anyway, but translations get the wrong string mixing the title and the content of the translation.
* Copyedit the legacy releng blurb.Pau Amma2022-09-291-1/+1
| | | | | | | | | A latter change might be to specify which version it was abandoned for but this will do for now. Reviewed by: fernape, gjb Approved by: fernape (docs), gjb (mentor, docs, releng)
* doc: Update source files (en .po), for translationsDanilo G. Baio2022-09-041-20/+20
|
* articles/contributors: Format email consistentlyFelix Palmen2022-08-221-13/+13
| | | | | | | | Always use angle brackets around email addresses, not only for addresses obtained from shared/authors. Approved by: carlavilla, tcberner (mentor) Differential Revision: https://reviews.freebsd.org/D36298