aboutsummaryrefslogtreecommitdiff
path: root/documentation/content/en/articles
Commit message (Collapse)AuthorAgeFilesLines
...
* 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
* doc: Add source .po files for translationsDanilo G. Baio2022-08-0738-0/+50386
| | | | | | | | | | | | | | | | | | This helps the Weblate translation workflow and offline translations through .po files, it's important to update these files constantly. The goal here is to have a semi-automated translation workflow; Weblate will pull updates automatically from the main repository and commit translations to another repository. Doc committers are encouraged to update the source .po files whenever there are updates in the English documentation part. $ ./tools/update_translate_template.sh documentation Anyway, I'll keep doing this periodically. Discussed with: doceng
* New committer (ports): Felix Palmen (zirias)Felix Palmen2022-08-031-0/+3
| | | | | | | Completed steps 1-4 from Committer's Guide. Approved by: tcberner (mentor) Differential Revision: https://reviews.freebsd.org/D36011
* Add records about new src committer (dsl)Dmitry Salychev2022-07-221-0/+3
| | | | | | | | | New author entry for Dmitry Salychev 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: bz (mentor) Differential Revision: https://reviews.freebsd.org/D35850
* New committer (doc): Pau Amma (steps 1-4)Pau Amma2022-07-101-0/+3
| | | | | | Approved by: gjb (mentor), carlavilla (mentor) Differential Revision: https://reviews.freebsd.org/D35692
* New committer (doc): Graham Perrin, grahamperrin@Graham Perrin2022-07-051-0/+3
| | | | | | | | | Committer's Guide, steps for new committers, steps 1–4. Mentors: Glen Barber (gjb) and Sergio Carlavilla (carlavilla). Approved by: carlavilla. Pull request: <https://github.com/freebsd/freebsd-doc/pull/80> Differential revision: <https://reviews.freebsd.org/D35603>
* rc-scripting: Update the path where scripts live in src treeMateusz Piotrowski2022-07-041-1/+1
|
* Improve Abstract section and some other improvements in ContributorsSergio Carlavilla Delgado2022-06-291-2/+3
| | | | | | | | | | * Improve abstract * Clarify that source tree make reference to all FreeBSD source trees (src, ports and doc) * Add a link to the current members of the Core Team PR: 264411 Submitted by: grahamperrin@