Units
Translation components API.
See the Weblate's Web API documentation for detailed description of the API.
GET /api/translations/documentation/articlescommitters-guide_index/en/units/?format=api&page=22
{ "count": 1102, "next": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/units/?format=api&page=23", "previous": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/units/?format=api&page=21", "results": [ { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "Before you begin, make sure that your local Git repo is up to date and has the correct origins set crossref:committers-guide[keeping_current,as shown above]." ], "previous_source": "", "target": [ "Before you begin, make sure that your local Git repo is up to date and has the correct origins set crossref:committers-guide[keeping_current,as shown above]." ], "id_hash": -1991047494644528030, "content_hash": -1991047494644528030, "location": "documentation/content/en/articles/committers-guide/_index.adoc:1973", "context": "", "note": "type: delimited block . 4", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 538, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 23, "source_unit": "https://translate-dev.freebsd.org/api/units/1706952/?format=api", "priority": 100, "id": 1706952, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=645e60da46c80c62", "url": "https://translate-dev.freebsd.org/api/units/1706952/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2024-09-14T19:38:20.975799Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "With this in place you can create a branch\ncrossref:committers-guide[keeping_a_local_branch,as shown above].\n" ], "previous_source": "", "target": [ "With this in place you can create a branch\ncrossref:committers-guide[keeping_a_local_branch,as shown above].\n" ], "id_hash": -8853907426420923412, "content_hash": -8853907426420923412, "location": "documentation/content/en/articles/committers-guide/_index.adoc:1996", "context": "", "note": "type: delimited block . 4", "flags": "no-wrap", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 543, "has_suggestion": false, "has_comment": false, "has_failing_check": true, "num_words": 12, "source_unit": "https://translate-dev.freebsd.org/api/units/1706954/?format=api", "priority": 100, "id": 1706954, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=05209a1b0dfce3ec", "url": "https://translate-dev.freebsd.org/api/units/1706954/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2024-09-14T19:38:20.983318Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "Before beginning, make sure that the local Git repo is up to date and has the correct origins set crossref:committers-guide[keeping_current,as shown above]. In addition, make sure to have the following origins: [source,shell]" ], "previous_source": "", "target": [ "Before beginning, make sure that the local Git repo is up to date and has the correct origins set crossref:committers-guide[keeping_current,as shown above]. In addition, make sure to have the following origins: [source,shell]" ], "id_hash": 8468087685997662253, "content_hash": 8468087685997662253, "location": "documentation/content/en/articles/committers-guide/_index.adoc:2065", "context": "", "note": "type: delimited block . 4", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 557, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 32, "source_unit": "https://translate-dev.freebsd.org/api/units/1706956/?format=api", "priority": 100, "id": 1706956, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=f584b0e272c0102d", "url": "https://translate-dev.freebsd.org/api/units/1706956/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2024-09-14T19:38:20.995760Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "The project has moved to crossref:committers-guide[git-primer,git]." ], "previous_source": "", "target": [ "The project has moved to crossref:committers-guide[git-primer,git]." ], "id_hash": 3345940705369541151, "content_hash": 3345940705369541151, "location": "documentation/content/en/articles/committers-guide/_index.adoc:2132", "context": "", "note": "type: delimited block . 4", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 568, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 6, "source_unit": "https://translate-dev.freebsd.org/api/units/1706958/?format=api", "priority": 100, "id": 1706958, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=ae6f2b580f124a1f", "url": "https://translate-dev.freebsd.org/api/units/1706958/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2024-09-14T19:38:21.006147Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "[[smtp-setup-local-mta]]\n" ], "previous_source": "", "target": [ "[[smtp-setup-local-mta]]\n" ], "id_hash": 1165683522566719915, "content_hash": 1165683522566719915, "location": "documentation/content/en/articles/committers-guide/_index.adoc:2268", "context": "", "note": "type: delimited block . 4", "flags": "no-wrap", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 588, "has_suggestion": false, "has_comment": false, "has_failing_check": true, "num_words": 1, "source_unit": "https://translate-dev.freebsd.org/api/units/1706964/?format=api", "priority": 100, "id": 1706964, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=902d56fcdb1d89ab", "url": "https://translate-dev.freebsd.org/api/units/1706964/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2024-09-14T19:38:21.168113Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "Authenticators:\nfreebsd_plain:\n driver = plaintext\n public_name = PLAIN\n client_send = ^example/mail^examplePassword\n client_condition = ${if eq{$host}{smtp.freebsd.org}}\n" ], "previous_source": "", "target": [ "Authenticators:\nfreebsd_plain:\n driver = plaintext\n public_name = PLAIN\n client_send = ^example/mail^examplePassword\n client_condition = ${if eq{$host}{smtp.freebsd.org}}\n" ], "id_hash": -3376236769099730864, "content_hash": -3376236769099730864, "location": "documentation/content/en/articles/committers-guide/_index.adoc:2378", "context": "", "note": "type: Plain text", "flags": "no-wrap", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 615, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 15, "source_unit": "https://translate-dev.freebsd.org/api/units/1706966/?format=api", "priority": 100, "id": 1706966, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=5125328bec32b050", "url": "https://translate-dev.freebsd.org/api/units/1706966/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2024-09-14T19:38:21.188397Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "When you commit a change in Git, Subversion, or another version control system (VCS), you're prompted to write some text describing the commit -- a commit message. How important is this commit message? Should you spend some significant effort writing it? Does it really matter if you write simply `fixed a bug`?" ], "previous_source": "", "target": [ "When you commit a change in Git, Subversion, or another version control system (VCS), you're prompted to write some text describing the commit -- a commit message. How important is this commit message? Should you spend some significant effort writing it? Does it really matter if you write simply `fixed a bug`?" ], "id_hash": 5861619873840210794, "content_hash": 5861619873840210794, "location": "documentation/content/en/articles/committers-guide/_index.adoc:2443", "context": "", "note": "type: delimited block . 4", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 636, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 52, "source_unit": "https://translate-dev.freebsd.org/api/units/1706970/?format=api", "priority": 100, "id": 1706970, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=d158a838149da36a", "url": "https://translate-dev.freebsd.org/api/units/1706970/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2024-09-14T19:38:21.207458Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "Consider the points raised under crossref:committers-guide[respect,Respect other committers] and apply them also to contributors." ], "previous_source": "", "target": [ "Consider the points raised under crossref:committers-guide[respect,Respect other committers] and apply them also to contributors." ], "id_hash": 3854459244108203370, "content_hash": 3854459244108203370, "location": "documentation/content/en/articles/committers-guide/_index.adoc:3137", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 852, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 14, "source_unit": "https://translate-dev.freebsd.org/api/units/1706976/?format=api", "priority": 100, "id": 1706976, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=b57dca42be4a456a", "url": "https://translate-dev.freebsd.org/api/units/1706976/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2024-09-14T19:38:21.380342Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "Adding a port to the tree is relatively simple. Once the port is ready to be added, as explained later crossref:committers-guide[ports-qa-add-new-extra,here], you need to add the port's directory entry in the category's [.filename]#Makefile#. In this [.filename]#Makefile#, ports are listed in alphabetical order and added to the `SUBDIR` variable, like this:" ], "previous_source": "", "target": [ "Adding a port to the tree is relatively simple. Once the port is ready to be added, as explained later crossref:committers-guide[ports-qa-add-new-extra,here], you need to add the port's directory entry in the category's [.filename]#Makefile#. In this [.filename]#Makefile#, ports are listed in alphabetical order and added to the `SUBDIR` variable, like this:" ], "id_hash": -2948803133690418325, "content_hash": -2948803133690418325, "location": "documentation/content/en/articles/committers-guide/_index.adoc:3495", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 975, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 50, "source_unit": "https://translate-dev.freebsd.org/api/units/1706980/?format=api", "priority": 100, "id": 1706980, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=5713bf2c5fd2eb6b", "url": "https://translate-dev.freebsd.org/api/units/1706980/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2024-09-14T19:38:21.469535Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "Don't forget to crossref:committers-guide[port-commit-message-formats,setup git hooks for the ports tree as explained here]; a specific hook has been developed to verify the category's [.filename]#Makefile#." ], "previous_source": "", "target": [ "Don't forget to crossref:committers-guide[port-commit-message-formats,setup git hooks for the ports tree as explained here]; a specific hook has been developed to verify the category's [.filename]#Makefile#." ], "id_hash": 7622750449286594542, "content_hash": 7622750449286594542, "location": "documentation/content/en/articles/committers-guide/_index.adoc:3511", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 979, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 24, "source_unit": "https://translate-dev.freebsd.org/api/units/1706982/?format=api", "priority": 100, "id": 1706982, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=e9c97325852d3fee", "url": "https://translate-dev.freebsd.org/api/units/1706982/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2024-09-14T19:38:21.474885Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "Almost all FreeBSD developers have commit rights to one or more repositories. However, a few developers do not, and some of the information here applies to them as well. (For instance, some people only have rights to work with the Problem Report database.) Please see crossref:committers-guide[non-committers, Issues Specific to Developers Who Are Not Committers] for more information." ], "previous_source": "", "target": [ "Almost all FreeBSD developers have commit rights to one or more repositories. However, a few developers do not, and some of the information here applies to them as well. (For instance, some people only have rights to work with the Problem Report database.) Please see crossref:committers-guide[non-committers, Issues Specific to Developers Who Are Not Committers] for more information." ], "id_hash": 2146555663363251964, "content_hash": 2146555663363251964, "location": "documentation/content/en/articles/committers-guide/_index.adoc:53", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 5, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 57, "source_unit": "https://translate-dev.freebsd.org/api/units/1713909/?format=api", "priority": 100, "id": 1713909, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=9dca1900bd5e9efc", "url": "https://translate-dev.freebsd.org/api/units/1713909/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2024-12-29T14:14:45.392876Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "`smtp.FreeBSD.org:587` (see also crossref:committers-guide[smtp-setup, SMTP Access Setup])." ], "previous_source": "", "target": [ "`smtp.FreeBSD.org:587` (see also crossref:committers-guide[smtp-setup, SMTP Access Setup])." ], "id_hash": -2262399738096958914, "content_hash": -2262399738096958914, "location": "documentation/content/en/articles/committers-guide/_index.adoc:79", "context": "", "note": "type: Table", "flags": "no-wrap", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 16, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 7, "source_unit": "https://translate-dev.freebsd.org/api/units/1713911/?format=api", "priority": 100, "id": 1713911, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=609a576cc6cb423e", "url": "https://translate-dev.freebsd.org/api/units/1713911/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2024-12-29T14:14:45.398822Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "man:ssh[1] is required to connect to the project hosts. For more information,\n\tsee crossref:committers-guide[ssh.guide, SSH Quick-Start Guide].\n" ], "previous_source": "", "target": [ "man:ssh[1] is required to connect to the project hosts. For more information,\n\tsee crossref:committers-guide[ssh.guide, SSH Quick-Start Guide].\n" ], "id_hash": 1563508567845151475, "content_hash": 1563508567845151475, "location": "documentation/content/en/articles/committers-guide/_index.adoc:103", "context": "", "note": "type: Plain text", "flags": "no-wrap", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 31, "has_suggestion": false, "has_comment": false, "has_failing_check": true, "num_words": 17, "source_unit": "https://translate-dev.freebsd.org/api/units/1713913/?format=api", "priority": 100, "id": 1713913, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=95b2b2c235b0a2f3", "url": "https://translate-dev.freebsd.org/api/units/1713913/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2024-12-29T14:14:45.403682Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "Cryptographic keys conforming to the OpenPGP (__Pretty Good Privacy__) standard are used by the FreeBSD project to authenticate committers. Messages carrying important information like public SSH keys can be signed with the OpenPGP key to prove that they are really from the committer. See https://nostarch.com/releases/pgp_release.pdf[PGP & GPG: Email for the Practical Paranoid by Michael Lucas] and https://en.wikipedia.org/wiki/Pretty_Good_Privacy[] for more information." ], "previous_source": "", "target": [ "Cryptographic keys conforming to the OpenPGP (__Pretty Good Privacy__) standard are used by the FreeBSD project to authenticate committers. Messages carrying important information like public SSH keys can be signed with the OpenPGP key to prove that they are really from the committer. See https://nostarch.com/releases/pgp_release.pdf[PGP & GPG: Email for the Practical Paranoid by Michael Lucas] and https://en.wikipedia.org/wiki/Pretty_Good_Privacy[] for more information." ], "id_hash": 8909608564085120517, "content_hash": 8909608564085120517, "location": "documentation/content/en/articles/committers-guide/_index.adoc:116", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 37, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 60, "source_unit": "https://translate-dev.freebsd.org/api/units/1713915/?format=api", "priority": 100, "id": 1713915, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=fba549c8ae125e05", "url": "https://translate-dev.freebsd.org/api/units/1713915/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2024-12-29T14:14:45.407348Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "You'll need to make sure that you've fetched the notes (see the crossref:committers-guide[git-mini-daily-use, Daily use]for details). Once you have these, notes will show up in the git log command like so:" ], "previous_source": "", "target": [ "You'll need to make sure that you've fetched the notes (see the crossref:committers-guide[git-mini-daily-use, Daily use]for details). Once you have these, notes will show up in the git log command like so:" ], "id_hash": 1087739322533853682, "content_hash": 1087739322533853682, "location": "documentation/content/en/articles/committers-guide/_index.adoc:1523", "context": "", "note": "type: delimited block . 4", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 421, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 31, "source_unit": "https://translate-dev.freebsd.org/api/units/1713917/?format=api", "priority": 100, "id": 1713917, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=8f186d2697dab9f2", "url": "https://translate-dev.freebsd.org/api/units/1713917/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2024-12-29T14:14:45.430502Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ ". Add an Author Entity\n+\n[.filename]#doc/shared/authors.adoc# - Add an author entity. Later steps depend on this entity, and missing this step will cause the [.filename]#doc/# build to fail. This is a relatively easy task, but remains a good first test of version control skills.\n. Update the List of Developers and Contributors\n+\n[.filename]#doc/shared/contrib-committers.adoc# - Add an entry, which will then appear in the \"Developers\" section of the extref:{contributors}[Contributors List, staff-committers]. Entries are sorted by last name.\n+\n[.filename]#doc/shared/contrib-additional.adoc# - _Remove_ the entry. Entries are sorted by first name.\n. Add a News Item\n+\n[.filename]#doc/website/data/en/news/news.toml# - Add an entry. Look for the other entries that announce new committers and follow the format. Use the date from the commit bit approval email.\n. Add a PGP Key\n+\n`{des}` has written a shell script ([.filename]#doc/documentation/tools/addkey.sh#) to make this easier. See the https://cgit.freebsd.org/doc/plain/documentation/static/pgpkeys/README[README] file for more information.\n+\nUse [.filename]#doc/documentation/tools/checkkey.sh# to verify that keys meet minimal best-practices standards.\n+\nAfter adding and checking a key, add both updated files to source control and then commit them. Entries in this file are sorted by last name.\n+\n[NOTE]\n======\nIt is very important to have a current PGP/GnuPG key in the repository. The key may be required for positive identification of a committer. For example, the `{admins}` might need it for account recovery. A complete keyring of `FreeBSD.org` users is available for download from link:https://docs.FreeBSD.org/pgpkeys/pgpkeys.txt[https://docs.FreeBSD.org/pgpkeys/pgpkeys.txt].\n======\n. Update Mentor and Mentee Information\n+\n[.filename]#src/share/misc/committers-<repository>.dot# - Add an entry to the current committers section, where _repository_ is `doc`, `ports`, or `src`, depending on the commit privileges granted.\n+\nAdd an entry for each additional mentor/mentee relationship in the bottom section.\n. Generate a Kerberos Password\n+\nSee crossref:committers-guide[kerberos-ldap, Kerberos and LDAP web Password for FreeBSD Cluster] to generate or set a Kerberos account for use with other FreeBSD services like the link:https://bugs.freebsd.org/bugzilla/[bug-tracking database] (you get a bug-tracking account as part of that step).\n. Optional: Enable Wiki Account\n+\nlink:https://wiki.freebsd.org[FreeBSD Wiki] Account - A wiki account allows sharing projects and ideas.\nThose who do not yet have an account can follow instructions on the link:https://wiki.freebsd.org/Wiki/About[Wiki/About page] to obtain one.\nContact mailto:wiki-admin@FreeBSD.org[wiki-admin@FreeBSD.org] if you need help with your Wiki account.\n. Optional: Update Wiki Information\n+\nWiki Information - After gaining access to the wiki, some people add entries to the https://wiki.freebsd.org/HowWeGotHere[How We Got Here], https://wiki.freebsd.org/IRC/Nicknames[IRC Nicks], https://wiki.freebsd.org/Community/Dogs[Dogs of FreeBSD], and or https://wiki.freebsd.org/Community/Cats[Cats of FreeBSD] pages.\n. Optional: Update Ports with Personal Information\n+\n[.filename]#ports/astro/xearth/files/freebsd.committers.markers# and [.filename]#src/usr.bin/calendar/calendars/calendar.freebsd# - Some people add entries for themselves to these files to show where they are located or the date of their birthday.\n. Optional: Prevent Duplicate Mailings\n+\nSubscribers to {dev-commits-doc-all}, {dev-commits-ports-all} or {dev-commits-src-all} might wish to unsubscribe to avoid receiving duplicate copies of commit messages and followups.\n====\n" ], "previous_source": "", "target": [ ". Add an Author Entity\n+\n[.filename]#doc/shared/authors.adoc# - Add an author entity. Later steps depend on this entity, and missing this step will cause the [.filename]#doc/# build to fail. This is a relatively easy task, but remains a good first test of version control skills.\n. Update the List of Developers and Contributors\n+\n[.filename]#doc/shared/contrib-committers.adoc# - Add an entry, which will then appear in the \"Developers\" section of the extref:{contributors}[Contributors List, staff-committers]. Entries are sorted by last name.\n+\n[.filename]#doc/shared/contrib-additional.adoc# - _Remove_ the entry. Entries are sorted by first name.\n. Add a News Item\n+\n[.filename]#doc/website/data/en/news/news.toml# - Add an entry. Look for the other entries that announce new committers and follow the format. Use the date from the commit bit approval email.\n. Add a PGP Key\n+\n`{des}` has written a shell script ([.filename]#doc/documentation/tools/addkey.sh#) to make this easier. See the https://cgit.freebsd.org/doc/plain/documentation/static/pgpkeys/README[README] file for more information.\n+\nUse [.filename]#doc/documentation/tools/checkkey.sh# to verify that keys meet minimal best-practices standards.\n+\nAfter adding and checking a key, add both updated files to source control and then commit them. Entries in this file are sorted by last name.\n+\n[NOTE]\n======\nIt is very important to have a current PGP/GnuPG key in the repository. The key may be required for positive identification of a committer. For example, the `{admins}` might need it for account recovery. A complete keyring of `FreeBSD.org` users is available for download from link:https://docs.FreeBSD.org/pgpkeys/pgpkeys.txt[https://docs.FreeBSD.org/pgpkeys/pgpkeys.txt].\n======\n. Update Mentor and Mentee Information\n+\n[.filename]#src/share/misc/committers-<repository>.dot# - Add an entry to the current committers section, where _repository_ is `doc`, `ports`, or `src`, depending on the commit privileges granted.\n+\nAdd an entry for each additional mentor/mentee relationship in the bottom section.\n. Generate a Kerberos Password\n+\nSee crossref:committers-guide[kerberos-ldap, Kerberos and LDAP web Password for FreeBSD Cluster] to generate or set a Kerberos account for use with other FreeBSD services like the link:https://bugs.freebsd.org/bugzilla/[bug-tracking database] (you get a bug-tracking account as part of that step).\n. Optional: Enable Wiki Account\n+\nlink:https://wiki.freebsd.org[FreeBSD Wiki] Account - A wiki account allows sharing projects and ideas.\nThose who do not yet have an account can follow instructions on the link:https://wiki.freebsd.org/Wiki/About[Wiki/About page] to obtain one.\nContact mailto:wiki-admin@FreeBSD.org[wiki-admin@FreeBSD.org] if you need help with your Wiki account.\n. Optional: Update Wiki Information\n+\nWiki Information - After gaining access to the wiki, some people add entries to the https://wiki.freebsd.org/HowWeGotHere[How We Got Here], https://wiki.freebsd.org/IRC/Nicknames[IRC Nicks], https://wiki.freebsd.org/Community/Dogs[Dogs of FreeBSD], and or https://wiki.freebsd.org/Community/Cats[Cats of FreeBSD] pages.\n. Optional: Update Ports with Personal Information\n+\n[.filename]#ports/astro/xearth/files/freebsd.committers.markers# and [.filename]#src/usr.bin/calendar/calendars/calendar.freebsd# - Some people add entries for themselves to these files to show where they are located or the date of their birthday.\n. Optional: Prevent Duplicate Mailings\n+\nSubscribers to {dev-commits-doc-all}, {dev-commits-ports-all} or {dev-commits-src-all} might wish to unsubscribe to avoid receiving duplicate copies of commit messages and followups.\n====\n" ], "id_hash": -2432725927400869598, "content_hash": -2432725927400869598, "location": "documentation/content/en/articles/committers-guide/_index.adoc:2217", "context": "", "note": "type: delimited block . 4", "flags": "no-wrap", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 580, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 463, "source_unit": "https://translate-dev.freebsd.org/api/units/1713919/?format=api", "priority": 100, "id": 1713919, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=5e3d38a87d637122", "url": "https://translate-dev.freebsd.org/api/units/1713919/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2024-12-29T14:14:45.442780Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "[.procedure]\n====\n. Point your mail client at `smtp.FreeBSD.org:587`.\n. Enable STARTTLS.\n. Ensure your `From:` address is set to `_yourusername_@FreeBSD.org`.\n. For authentication, you can use your FreeBSD Kerberos username and password\n (see crossref:committers-guide[kerberos-ldap, Kerberos and LDAP web Password for FreeBSD Cluster]). The `_yourusername_/mail` principal is preferred, as it is only valid for authenticating to mail resources.\n+\n[NOTE]\n======\nDo not include `@FreeBSD.org` when entering in your username.\n======\n+\n.Additional Notes\n[NOTE]\n======\n* Will only accept mail from `_yourusername_@FreeBSD.org`. If you are authenticated as one user, you are not permitted to send mail from another.\n* A header will be appended with the SASL username: (`Authenticated sender: _username_`).\n* Host has various rate limits in place to cut down on brute force attempts.\n======\n====\n" ], "previous_source": "", "target": [ "[.procedure]\n====\n. Point your mail client at `smtp.FreeBSD.org:587`.\n. Enable STARTTLS.\n. Ensure your `From:` address is set to `_yourusername_@FreeBSD.org`.\n. For authentication, you can use your FreeBSD Kerberos username and password\n (see crossref:committers-guide[kerberos-ldap, Kerberos and LDAP web Password for FreeBSD Cluster]). The `_yourusername_/mail` principal is preferred, as it is only valid for authenticating to mail resources.\n+\n[NOTE]\n======\nDo not include `@FreeBSD.org` when entering in your username.\n======\n+\n.Additional Notes\n[NOTE]\n======\n* Will only accept mail from `_yourusername_@FreeBSD.org`. If you are authenticated as one user, you are not permitted to send mail from another.\n* A header will be appended with the SASL username: (`Authenticated sender: _username_`).\n* Host has various rate limits in place to cut down on brute force attempts.\n======\n====\n" ], "id_hash": -6610298895237556757, "content_hash": -6610298895237556757, "location": "documentation/content/en/articles/committers-guide/_index.adoc:2266", "context": "", "note": "type: delimited block . 4", "flags": "no-wrap", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 587, "has_suggestion": false, "has_comment": false, "has_failing_check": true, "num_words": 129, "source_unit": "https://translate-dev.freebsd.org/api/units/1713921/?format=api", "priority": 100, "id": 1713921, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=2443802d7a3555eb", "url": "https://translate-dev.freebsd.org/api/units/1713921/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2024-12-29T14:14:45.450044Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "When the mentor decides that a mentee has learned the ropes and is ready to commit on their own, the mentor announces it with a commit to [.filename]#mentors#. This file is in the [.filename]#admin# orphan branch of each repository. Detailed information on how to access these branches can be found in crossref:committers-guide[admin-branch, \"admin\" branch]." ], "previous_source": "", "target": [ "When the mentor decides that a mentee has learned the ropes and is ready to commit on their own, the mentor announces it with a commit to [.filename]#mentors#. This file is in the [.filename]#admin# orphan branch of each repository. Detailed information on how to access these branches can be found in crossref:committers-guide[admin-branch, \"admin\" branch]." ], "id_hash": 4224305289315826630, "content_hash": 4224305289315826630, "location": "documentation/content/en/articles/committers-guide/_index.adoc:2403", "context": "", "note": "type: delimited block . 4", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 623, "has_suggestion": false, "has_comment": false, "has_failing_check": true, "num_words": 54, "source_unit": "https://translate-dev.freebsd.org/api/units/1713923/?format=api", "priority": 100, "id": 1713923, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=ba9fbf4780793bc6", "url": "https://translate-dev.freebsd.org/api/units/1713923/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2024-12-29T14:14:45.456832Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "`Discussed with:`" ], "previous_source": "", "target": [ "`Discussed with:`" ], "id_hash": 7856505521559340577, "content_hash": 7856505521559340577, "location": "documentation/content/en/articles/committers-guide/_index.adoc:2604", "context": "", "note": "type: Table", "flags": "no-wrap", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 693, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 2, "source_unit": "https://translate-dev.freebsd.org/api/units/1713925/?format=api", "priority": 100, "id": 1713925, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=ed07ea2574708621", "url": "https://translate-dev.freebsd.org/api/units/1713925/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2024-12-29T14:14:45.464356Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "The name and e-mail address of the person or people that contributed to the patch by providing meaningful feedback; for developers, just the username on the FreeBSD cluster.\nTypically used to credit those who did not explicitly review, test, or approve the change, but nevertheless contributed to the discussion surrounding the change, which led to improvements and a better understanding of its impact on the FreeBSD project." ], "previous_source": "", "target": [ "The name and e-mail address of the person or people that contributed to the patch by providing meaningful feedback; for developers, just the username on the FreeBSD cluster.\nTypically used to credit those who did not explicitly review, test, or approve the change, but nevertheless contributed to the discussion surrounding the change, which led to improvements and a better understanding of its impact on the FreeBSD project." ], "id_hash": 1576684855738116167, "content_hash": 1576684855738116167, "location": "documentation/content/en/articles/committers-guide/_index.adoc:2607", "context": "", "note": "type: Table", "flags": "no-wrap", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 694, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 67, "source_unit": "https://translate-dev.freebsd.org/api/units/1713927/?format=api", "priority": 100, "id": 1713927, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=95e18285cd022847", "url": "https://translate-dev.freebsd.org/api/units/1713927/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2024-12-29T14:14:45.467585Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "The project uses https://spdx.dev[SPDX] tags in our source base. At present, these tags are indented to help automated tools reconstruct license requirements mechanically. All _SPDX-License-Identifier_ tags in the tree should be considered to be informative. All files in the FreeBSD source tree with these tags also have a copy of the license which governs use of that file. In the event of a discrepancy, the verbatim license is controlling. The project tries to follow the https://spdx.github.io/spdx-spec/v2.2.2/[SPDX Specification, Version 2.2]. How to mark source files and valid algebraic expressions are found in https://spdx.github.io/spdx-spec/v2.2.2/SPDX-license-expressions/[Annex D] and https://spdx.github.io/spdx-spec/v2.2.2/using-SPDX-short-identifiers-in-source-files/[Annex E]. The project draws identifiers from SPDX's list of valid https://spdx.org/licenses/[short license identifiers]. The project uses only the _SPDX-License-Identifier_ tag." ], "previous_source": "", "target": [ "The project uses https://spdx.dev[SPDX] tags in our source base. At present, these tags are indented to help automated tools reconstruct license requirements mechanically. All _SPDX-License-Identifier_ tags in the tree should be considered to be informative. All files in the FreeBSD source tree with these tags also have a copy of the license which governs use of that file. In the event of a discrepancy, the verbatim license is controlling. The project tries to follow the https://spdx.github.io/spdx-spec/v2.2.2/[SPDX Specification, Version 2.2]. How to mark source files and valid algebraic expressions are found in https://spdx.github.io/spdx-spec/v2.2.2/SPDX-license-expressions/[Annex D] and https://spdx.github.io/spdx-spec/v2.2.2/using-SPDX-short-identifiers-in-source-files/[Annex E]. The project draws identifiers from SPDX's list of valid https://spdx.org/licenses/[short license identifiers]. The project uses only the _SPDX-License-Identifier_ tag." ], "id_hash": 70787710459997254, "content_hash": 70787710459997254, "location": "documentation/content/en/articles/committers-guide/_index.adoc:2878", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 767, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 115, "source_unit": "https://translate-dev.freebsd.org/api/units/1713931/?format=api", "priority": 100, "id": 1713931, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=80fb7d0c306e6c46", "url": "https://translate-dev.freebsd.org/api/units/1713931/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2024-12-29T14:14:45.618376Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "Log in using `FreeBSD.org` account and post comment to newly opened bug to confirm ownership. See crossref:committers-guide[kerberos-ldap, Kerberos and LDAP web Password for FreeBSD Cluster] for more details on how to generate or set a password for your `FreeBSD.org` account." ], "previous_source": "", "target": [ "Log in using `FreeBSD.org` account and post comment to newly opened bug to confirm ownership. See crossref:committers-guide[kerberos-ldap, Kerberos and LDAP web Password for FreeBSD Cluster] for more details on how to generate or set a password for your `FreeBSD.org` account." ], "id_hash": -5029195953092909579, "content_hash": -5029195953092909579, "location": "documentation/content/en/articles/committers-guide/_index.adoc:2961", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 794, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 40, "source_unit": "https://translate-dev.freebsd.org/api/units/1713933/?format=api", "priority": 100, "id": 1713933, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=3a34b4ed2e10a5f5", "url": "https://translate-dev.freebsd.org/api/units/1713933/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2024-12-29T14:14:45.638821Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "Open new bug on our bug tracker using your `FreeBSD.org` account, see crossref:committers-guide[bugzilla, Bugzilla] for more information. Choose `Services` as the Product, and `Code Review` as the Component. In bug description request that your Phabricator account be renamed, and provide a link to your Phabricator user. For example, `https://reviews.freebsd.org/p/bob_example.com/`" ], "previous_source": "", "target": [ "Open new bug on our bug tracker using your `FreeBSD.org` account, see crossref:committers-guide[bugzilla, Bugzilla] for more information. Choose `Services` as the Product, and `Code Review` as the Component. In bug description request that your Phabricator account be renamed, and provide a link to your Phabricator user. For example, `https://reviews.freebsd.org/p/bob_example.com/`" ], "id_hash": -5964786124479149241, "content_hash": -5964786124479149241, "location": "documentation/content/en/articles/committers-guide/_index.adoc:2982", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 803, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 49, "source_unit": "https://translate-dev.freebsd.org/api/units/1713935/?format=api", "priority": 100, "id": 1713935, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=2d38d29f613dcb47", "url": "https://translate-dev.freebsd.org/api/units/1713935/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2024-12-29T14:14:45.647044Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "For more information on how to merge commits to the quarterly branch, see crossref:committers-guide[ports-qa-misc-request-mfh, What is the procedure to request authorization for merging a commit to the quarterly branch?]." ], "previous_source": "", "target": [ "For more information on how to merge commits to the quarterly branch, see crossref:committers-guide[ports-qa-misc-request-mfh, What is the procedure to request authorization for merging a commit to the quarterly branch?]." ], "id_hash": -7700064137545034438, "content_hash": -7700064137545034438, "location": "documentation/content/en/articles/committers-guide/_index.adoc:3615", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 1015, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 29, "source_unit": "https://translate-dev.freebsd.org/api/units/1713937/?format=api", "priority": 100, "id": 1713937, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=1523e076ade7553a", "url": "https://translate-dev.freebsd.org/api/units/1713937/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2024-12-29T14:14:45.982178Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "crossref:committers-guide[admin, Administrative Details]" ], "previous_source": "", "target": [ "crossref:committers-guide[admin, Administrative Details]" ], "id_hash": -8540475959510949711, "content_hash": -8540475959510949711, "location": "documentation/content/en/articles/committers-guide/_index.adoc:3764", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 1077, "has_suggestion": false, "has_comment": false, "has_failing_check": true, "num_words": 3, "source_unit": "https://translate-dev.freebsd.org/api/units/1713939/?format=api", "priority": 100, "id": 1713939, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=097a225d3c9620b1", "url": "https://translate-dev.freebsd.org/api/units/1713939/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2024-12-29T14:14:46.022481Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "crossref:committers-guide[conventions-everyone, For Everyone]" ], "previous_source": "", "target": [ "crossref:committers-guide[conventions-everyone, For Everyone]" ], "id_hash": 583196315005376852, "content_hash": 583196315005376852, "location": "documentation/content/en/articles/committers-guide/_index.adoc:3765", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 1078, "has_suggestion": false, "has_comment": false, "has_failing_check": true, "num_words": 3, "source_unit": "https://translate-dev.freebsd.org/api/units/1713941/?format=api", "priority": 100, "id": 1713941, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=8817edf566365954", "url": "https://translate-dev.freebsd.org/api/units/1713941/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2024-12-29T14:14:46.025816Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "crossref:committers-guide[developer.relations, Developer Relations]" ], "previous_source": "", "target": [ "crossref:committers-guide[developer.relations, Developer Relations]" ], "id_hash": -6854537353362380787, "content_hash": -6854537353362380787, "location": "documentation/content/en/articles/committers-guide/_index.adoc:3771", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 1080, "has_suggestion": false, "has_comment": false, "has_failing_check": true, "num_words": 3, "source_unit": "https://translate-dev.freebsd.org/api/units/1713943/?format=api", "priority": 100, "id": 1713943, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=20dfca981130680d", "url": "https://translate-dev.freebsd.org/api/units/1713943/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2024-12-29T14:14:46.029761Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "crossref:committers-guide[ssh.guide, SSH Quick-Start Guide]" ], "previous_source": "", "target": [ "crossref:committers-guide[ssh.guide, SSH Quick-Start Guide]" ], "id_hash": 8146631002594172121, "content_hash": 8146631002594172121, "location": "documentation/content/en/articles/committers-guide/_index.adoc:3772", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 1081, "has_suggestion": false, "has_comment": false, "has_failing_check": true, "num_words": 4, "source_unit": "https://translate-dev.freebsd.org/api/units/1713945/?format=api", "priority": 100, "id": 1713945, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=f10ea5bbf1cf5cd9", "url": "https://translate-dev.freebsd.org/api/units/1713945/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2024-12-29T14:14:46.032968Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "crossref:committers-guide[rules, The FreeBSD Committers' Big List of Rules]" ], "previous_source": "", "target": [ "crossref:committers-guide[rules, The FreeBSD Committers' Big List of Rules]" ], "id_hash": -3294647405205261166, "content_hash": -3294647405205261166, "location": "documentation/content/en/articles/committers-guide/_index.adoc:3773", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 1082, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 8, "source_unit": "https://translate-dev.freebsd.org/api/units/1713947/?format=api", "priority": 100, "id": 1713947, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=52470fa40893f492", "url": "https://translate-dev.freebsd.org/api/units/1713947/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2024-12-29T14:14:46.036191Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "For key words where multiple values make sense (e.g., `PR:` with a comma-separated list of PRs), it is permitted to use the same keyword multiple times to avoid ambiguity or improve readability." ], "previous_source": "", "target": [ "For key words where multiple values make sense (e.g., `PR:` with a comma-separated list of PRs), it is permitted to use the same keyword multiple times to avoid ambiguity or improve readability." ], "id_hash": -6625439122666981950, "content_hash": -6625439122666981950, "location": "documentation/content/en/articles/committers-guide/_index.adoc:2565", "context": "", "note": "type: delimited block . 4", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 680, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 32, "source_unit": "https://translate-dev.freebsd.org/api/units/1768692/?format=api", "priority": 100, "id": 1768692, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=240db638947575c2", "url": "https://translate-dev.freebsd.org/api/units/1768692/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2025-05-02T01:18:26.006561Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "/*\n * SPDX-License-Identifier: BSD-2-Clause\n *\n * Copyright (c) [year] [your name]\n *\n * Redistribution and use in source and binary forms, with or without\n * modification, are permitted provided that the following conditions\n * are met:\n * 1. Redistributions of source code must retain the above copyright\n * notice, this list of conditions and the following disclaimer.\n * 2. Redistributions in binary form must reproduce the above copyright\n * notice, this list of conditions and the following disclaimer in the\n * documentation and/or other materials provided with the distribution.\n *\n * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND\n * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\n * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE\n * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE\n * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\n * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS\n * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)\n * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT\n * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY\n * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF\n * SUCH DAMAGE.\n *\n * [id for your version control system, if any]\n */\n" ], "previous_source": "", "target": [ "/*\n * SPDX-License-Identifier: BSD-2-Clause\n *\n * Copyright (c) [year] [your name]\n *\n * Redistribution and use in source and binary forms, with or without\n * modification, are permitted provided that the following conditions\n * are met:\n * 1. Redistributions of source code must retain the above copyright\n * notice, this list of conditions and the following disclaimer.\n * 2. Redistributions in binary form must reproduce the above copyright\n * notice, this list of conditions and the following disclaimer in the\n * documentation and/or other materials provided with the distribution.\n *\n * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND\n * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\n * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE\n * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE\n * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\n * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS\n * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)\n * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT\n * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY\n * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF\n * SUCH DAMAGE.\n *\n * [id for your version control system, if any]\n */\n" ], "id_hash": -656454260261240791, "content_hash": -656454260261240791, "location": "documentation/content/en/articles/committers-guide/_index.adoc:2823", "context": "", "note": "type: delimited block . 4", "flags": "no-wrap", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 750, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 226, "source_unit": "https://translate-dev.freebsd.org/api/units/1768694/?format=api", "priority": 100, "id": 1768694, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=76e3ce540dd64029", "url": "https://translate-dev.freebsd.org/api/units/1768694/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2025-05-02T01:18:26.046350Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "srcmgr@" ], "previous_source": "", "target": [ "srcmgr@" ], "id_hash": -8487400679908762511, "content_hash": -8487400679908762511, "location": "documentation/content/en/articles/committers-guide/_index.adoc:247", "context": "", "note": "type: Table", "flags": "no-wrap", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 70, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 1, "source_unit": "https://translate-dev.freebsd.org/api/units/1813146/?format=api", "priority": 100, "id": 1813146, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=0a36b20cbfa11c71", "url": "https://translate-dev.freebsd.org/api/units/1813146/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2025-06-29T20:47:35.513328Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "Committers can acquire an additional bit by the usual process of finding a mentor who will propose them to srcmgr, doceng, or portmgr, as appropriate. When approved, they will be added to 'access' and the normal mentoring period will ensue, which will involve a continuing of \"Approved by\" for some period." ], "previous_source": "", "target": [ "Committers can acquire an additional bit by the usual process of finding a mentor who will propose them to srcmgr, doceng, or portmgr, as appropriate. When approved, they will be added to 'access' and the normal mentoring period will ensue, which will involve a continuing of \"Approved by\" for some period." ], "id_hash": 3190194326739130331, "content_hash": 3190194326739130331, "location": "documentation/content/en/articles/committers-guide/_index.adoc:271", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 84, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 51, "source_unit": "https://translate-dev.freebsd.org/api/units/1813148/?format=api", "priority": 100, "id": 1813148, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=ac45d8d679c097db", "url": "https://translate-dev.freebsd.org/api/units/1813148/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2025-06-29T20:47:35.519721Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "% git checkout -b issue # Create the 'issue' branch\n% git checkout -B main freebsd/main # Reset main to upstream\n% git checkout issue # Back to where you were\n" ], "previous_source": "", "target": [ "% git checkout -b issue # Create the 'issue' branch\n% git checkout -B main freebsd/main # Reset main to upstream\n% git checkout issue # Back to where you were\n" ], "id_hash": 5682344707605709572, "content_hash": 5682344707605709572, "location": "documentation/content/en/articles/committers-guide/_index.adoc:1615", "context": "", "note": "type: Plain text", "flags": "no-wrap", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 448, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 31, "source_unit": "https://translate-dev.freebsd.org/api/units/1813150/?format=api", "priority": 100, "id": 1813150, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=cedbbe67bc28c304", "url": "https://translate-dev.freebsd.org/api/units/1813150/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2025-06-29T20:47:35.544524Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "If it is not the last commit, you can cherry-pick that one change from wilma onto fred, then use `git rebase -i` to remove the change from wilma.\n" ], "previous_source": "", "target": [ "If it is not the last commit, you can cherry-pick that one change from wilma onto fred, then use `git rebase -i` to remove the change from wilma.\n" ], "id_hash": -6756830994385654044, "content_hash": -6756830994385654044, "location": "documentation/content/en/articles/committers-guide/_index.adoc:1636", "context": "", "note": "type: delimited block . 4", "flags": "no-wrap", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 453, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 28, "source_unit": "https://translate-dev.freebsd.org/api/units/1813152/?format=api", "priority": 100, "id": 1813152, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=223aea02844b2ee4", "url": "https://translate-dev.freebsd.org/api/units/1813152/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2025-06-29T20:47:35.549922Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "# We're on branch wilma\n% git checkout fred\t\t\t# move to fred branch\n% git cherry-pick HASH_OF_CHANGE\t# copy the misplaced commit\n% git rebase -i main wilma\t\t# drop the cherry-picked change\n" ], "previous_source": "", "target": [ "# We're on branch wilma\n% git checkout fred\t\t\t# move to fred branch\n% git cherry-pick HASH_OF_CHANGE\t# copy the misplaced commit\n% git rebase -i main wilma\t\t# drop the cherry-picked change\n" ], "id_hash": -3980048998893889826, "content_hash": -3980048998893889826, "location": "documentation/content/en/articles/committers-guide/_index.adoc:1643", "context": "", "note": "type: Plain text", "flags": "no-wrap", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 454, "has_suggestion": false, "has_comment": false, "has_failing_check": true, "num_words": 34, "source_unit": "https://translate-dev.freebsd.org/api/units/1813154/?format=api", "priority": 100, "id": 1813154, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=48c40685d047d6de", "url": "https://translate-dev.freebsd.org/api/units/1813154/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2025-06-29T20:47:35.554902Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "Many developers use `git pull --rebase` to avoid this situation.\n" ], "previous_source": "", "target": [ "Many developers use `git pull --rebase` to avoid this situation.\n" ], "id_hash": -4998285051846449819, "content_hash": -4998285051846449819, "location": "documentation/content/en/articles/committers-guide/_index.adoc:1759", "context": "", "note": "type: delimited block . 4", "flags": "no-wrap", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 478, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 10, "source_unit": "https://translate-dev.freebsd.org/api/units/1813156/?format=api", "priority": 100, "id": 1813156, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=3aa2863a368c2565", "url": "https://translate-dev.freebsd.org/api/units/1813156/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2025-06-29T20:47:35.575300Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "git reset --hard HEAD^1" ], "previous_source": "", "target": [ "git reset --hard HEAD^1" ], "id_hash": -1482096782768267069, "content_hash": -1482096782768267069, "location": "documentation/content/en/articles/committers-guide/_index.adoc:1775", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 482, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 4, "source_unit": "https://translate-dev.freebsd.org/api/units/1813158/?format=api", "priority": 100, "id": 1813158, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=6b6e88d41c5920c3", "url": "https://translate-dev.freebsd.org/api/units/1813158/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2025-06-29T20:47:35.581303Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "In addition, a `git pull --rebase` at this stage will rebase your changes to 'main' to the latest 'freebsd/main'.\n" ], "previous_source": "", "target": [ "In addition, a `git pull --rebase` at this stage will rebase your changes to 'main' to the latest 'freebsd/main'.\n" ], "id_hash": 1850510850398806136, "content_hash": 1850510850398806136, "location": "documentation/content/en/articles/committers-guide/_index.adoc:1778", "context": "", "note": "type: delimited block . 4", "flags": "no-wrap", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 483, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 19, "source_unit": "https://translate-dev.freebsd.org/api/units/1813160/?format=api", "priority": 100, "id": 1813160, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=99ae55d06306e078", "url": "https://translate-dev.freebsd.org/api/units/1813160/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2025-06-29T20:47:35.585018Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "Joining the FreeBSD GitHub oranization." ], "previous_source": "", "target": [ "Joining the FreeBSD GitHub oranization." ], "id_hash": -2292611335627664961, "content_hash": -2292611335627664961, "location": "documentation/content/en/articles/committers-guide/_index.adoc:1891", "context": "", "note": "type: Title =====", "flags": "no-wrap", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 513, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 5, "source_unit": "https://translate-dev.freebsd.org/api/units/1813162/?format=api", "priority": 100, "id": 1813162, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=602f022313e111bf", "url": "https://translate-dev.freebsd.org/api/units/1813162/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2025-06-29T20:47:35.609155Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "**Q:** How do I join the FreeBSD GitHub organization?\n" ], "previous_source": "", "target": [ "**Q:** How do I join the FreeBSD GitHub organization?\n" ], "id_hash": -122321750888530030, "content_hash": -122321750888530030, "location": "documentation/content/en/articles/committers-guide/_index.adoc:1894", "context": "", "note": "type: delimited block . 4", "flags": "no-wrap", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 514, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 9, "source_unit": "https://translate-dev.freebsd.org/api/units/1813164/?format=api", "priority": 100, "id": 1813164, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=7e4d6d0401fc3f92", "url": "https://translate-dev.freebsd.org/api/units/1813164/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2025-06-29T20:47:35.612871Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "**A:** Please see https://wiki.freebsd.org/GitHub#Joining_the_Organisation[our GitHub Wiki Info] page for details.\nBriefly, all FreeBSD committers may join.\nThose who are not committers who request joining will be considered on a case by case basis.\n" ], "previous_source": "", "target": [ "**A:** Please see https://wiki.freebsd.org/GitHub#Joining_the_Organisation[our GitHub Wiki Info] page for details.\nBriefly, all FreeBSD committers may join.\nThose who are not committers who request joining will be considered on a case by case basis.\n" ], "id_hash": 1028908208064774780, "content_hash": 1028908208064774780, "location": "documentation/content/en/articles/committers-guide/_index.adoc:1898", "context": "", "note": "type: delimited block . 4", "flags": "no-wrap", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 515, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 33, "source_unit": "https://translate-dev.freebsd.org/api/units/1813166/?format=api", "priority": 100, "id": 1813166, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=8e476a90582f427c", "url": "https://translate-dev.freebsd.org/api/units/1813166/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2025-06-29T20:47:35.616343Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "The Git short hash and the title line of a commit that is fixed by this change as returned by `git log -n 1 --pretty=format:'%h (\"%s\")' GIT-COMMIT-HASH`.\nWe include the commit title so that the referenced commit can be located even in the case that a future VCS migration invalidates hash references." ], "previous_source": "", "target": [ "The Git short hash and the title line of a commit that is fixed by this change as returned by `git log -n 1 --pretty=format:'%h (\"%s\")' GIT-COMMIT-HASH`.\nWe include the commit title so that the referenced commit can be located even in the case that a future VCS migration invalidates hash references." ], "id_hash": 7910426820073291950, "content_hash": 7910426820073291950, "location": "documentation/content/en/articles/committers-guide/_index.adoc:2641", "context": "", "note": "type: Table", "flags": "no-wrap", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 700, "has_suggestion": false, "has_comment": false, "has_failing_check": true, "num_words": 52, "source_unit": "https://translate-dev.freebsd.org/api/units/1813168/?format=api", "priority": 100, "id": 1813168, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=edc77b48183100ae", "url": "https://translate-dev.freebsd.org/api/units/1813168/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2025-06-29T20:47:35.729505Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "If your changes are to the kernel, make sure you can still compile both GENERIC and LINT. If your changes are anywhere else, make sure you can still compile userspace via `make buildworld`. If your changes are to a branch, make sure your testing occurs with a machine which is running that code. If you have a change which also may break another architecture, be sure and test on all supported architectures. Please ensure your change works for crossref:committers-guide[compilers,supported toolchains]. Please refer to the https://www.FreeBSD.org/internal/[FreeBSD Internal Page] for a list of available resources. As other architectures are added to the FreeBSD supported platforms list, the appropriate shared testing resources will be made available." ], "previous_source": "", "target": [ "If your changes are to the kernel, make sure you can still compile both GENERIC and LINT. If your changes are anywhere else, make sure you can still compile userspace via `make buildworld`. If your changes are to a branch, make sure your testing occurs with a machine which is running that code. If you have a change which also may break another architecture, be sure and test on all supported architectures. Please ensure your change works for crossref:committers-guide[compilers,supported toolchains]. Please refer to the https://www.FreeBSD.org/internal/[FreeBSD Internal Page] for a list of available resources. As other architectures are added to the FreeBSD supported platforms list, the appropriate shared testing resources will be made available." ], "id_hash": 5449999441435123979, "content_hash": 5449999441435123979, "location": "documentation/content/en/articles/committers-guide/_index.adoc:3197", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 865, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 113, "source_unit": "https://translate-dev.freebsd.org/api/units/1813170/?format=api", "priority": 100, "id": 1813170, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=cba2499ddcd1610b", "url": "https://translate-dev.freebsd.org/api/units/1813170/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2025-06-29T20:47:35.908600Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "In an effort to make it easier to keep FreeBSD portable across the platforms we support, core has developed this mandate:" ], "previous_source": "", "target": [ "In an effort to make it easier to keep FreeBSD portable across the platforms we support, core has developed this mandate:" ], "id_hash": 1432379770322340823, "content_hash": 1432379770322340823, "location": "documentation/content/en/articles/committers-guide/_index.adoc:3216", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 871, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 21, "source_unit": "https://translate-dev.freebsd.org/api/units/1813172/?format=api", "priority": 100, "id": 1813172, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=93e0d5cfe184cbd7", "url": "https://translate-dev.freebsd.org/api/units/1813172/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2025-06-29T20:47:35.926311Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "Major design work (including major API and ABI changes) must prove itself on at least one Tier 1 platform before it may be committed to the source tree." ], "previous_source": "", "target": [ "Major design work (including major API and ABI changes) must prove itself on at least one Tier 1 platform before it may be committed to the source tree." ], "id_hash": -401959333011006412, "content_hash": -401959333011006412, "location": "documentation/content/en/articles/committers-guide/_index.adoc:3219", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 872, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 28, "source_unit": "https://translate-dev.freebsd.org/api/units/1813174/?format=api", "priority": 100, "id": 1813174, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=7a6bf41dc5b9dc34", "url": "https://translate-dev.freebsd.org/api/units/1813174/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2025-06-29T20:47:35.931230Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "The FreeBSD base system builds with both Clang and GCC. The project does this in a careful and controlled way to maximize benefits from this extra work, while keeping the extra work to a minimum. Supporting both Clang and GCC improves the flexibility our users have. These compilers have different strengths and weaknesses, and supporting both allows users to pick the best one for their needs. Clang and GCC support similar dialects of C and C++, necessitating a relatively small amount of conditional code. The project gains increased code coverage and improves the code quality by using features from both compilers. The project is able to build in more user environments and leverage more CI environments by supporting this range, increasing convenience for users and giving them more tools to test with. By carefully constraining the range of versions supported to modern versions of these compilers, the project avoids unduly increasing the testing matrix. Older and obscure compilers, as well as older dialects of the languages, have extremely limited support that allow user programs to build with them, but without constraining the base system to being built with them. The exact balance continues to evolve to ensure the benefits of extra work remain greater than the burdens it imposes. The project used to support really old Intel compilers or old GCC versions, but we traded supporting those obsolete compilers for a carefully selected range of modern compilers. This section documents where we use different compilers, and the expectations around that." ], "previous_source": "", "target": [ "The FreeBSD base system builds with both Clang and GCC. The project does this in a careful and controlled way to maximize benefits from this extra work, while keeping the extra work to a minimum. Supporting both Clang and GCC improves the flexibility our users have. These compilers have different strengths and weaknesses, and supporting both allows users to pick the best one for their needs. Clang and GCC support similar dialects of C and C++, necessitating a relatively small amount of conditional code. The project gains increased code coverage and improves the code quality by using features from both compilers. The project is able to build in more user environments and leverage more CI environments by supporting this range, increasing convenience for users and giving them more tools to test with. By carefully constraining the range of versions supported to modern versions of these compilers, the project avoids unduly increasing the testing matrix. Older and obscure compilers, as well as older dialects of the languages, have extremely limited support that allow user programs to build with them, but without constraining the base system to being built with them. The exact balance continues to evolve to ensure the benefits of extra work remain greater than the burdens it imposes. The project used to support really old Intel compilers or old GCC versions, but we traded supporting those obsolete compilers for a carefully selected range of modern compilers. This section documents where we use different compilers, and the expectations around that." ], "id_hash": -689386979466778429, "content_hash": -689386979466778429, "location": "documentation/content/en/articles/committers-guide/_index.adoc:3239", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 875, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 250, "source_unit": "https://translate-dev.freebsd.org/api/units/1813176/?format=api", "priority": 100, "id": 1813176, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=766ece31d81a68c3", "url": "https://translate-dev.freebsd.org/api/units/1813176/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2025-06-29T20:47:35.936403Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "The FreeBSD base system includes an in-tree Clang compiler. Due to being in the tree, this compiler is the most supported compiler. All changes must compile with it, prior to commit. Complete testing, as appropriate for the change, should be done with this compiler." ], "previous_source": "", "target": [ "The FreeBSD base system includes an in-tree Clang compiler. Due to being in the tree, this compiler is the most supported compiler. All changes must compile with it, prior to commit. Complete testing, as appropriate for the change, should be done with this compiler." ], "id_hash": 5495460910083037357, "content_hash": 5495460910083037357, "location": "documentation/content/en/articles/committers-guide/_index.adoc:3244", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 876, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 44, "source_unit": "https://translate-dev.freebsd.org/api/units/1813178/?format=api", "priority": 100, "id": 1813178, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=cc43cc94de8b58ad", "url": "https://translate-dev.freebsd.org/api/units/1813178/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2025-06-29T20:47:35.941548Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "The FreeBSD base system also supports various versions of Clang and GCC as out-of-tree compilers. For large or risky changes, committers should do a test build with a supported version of GCC. Out of tree compilers are available as packages. GCC compilers are available as `${TARGET_ARCH}-gcc${VERSION}` packages, such as package:devel/freebsd-gcc14@aarch64[aarch64-gcc14]. Clang compilers are available as `llvm${VERSION}` packages, such as package:devel/llvm18[llvm18]. The project runs automated CI jobs to build everything with these compilers. Committers are expected to fix the jobs they break with their changes. Committers may test builds of userspace or individual kernels by setting `CROSS_TOOLCHAIN` to the package name, for example `CROSS_TOOLCHAIN=aarch64-gcc14` or `CROSS_TOOLCHAIN=llvm18`. For universe or tinderbox builds, `USE_GCC_TOOLCHAINS=gcc${VERSION}` builds all architectures using the appropriate GCC compiler packages. For universe or tinderbox builds using an out-of-tree Clang, pass `CROSS_TOOLCHAIN=llvm${VERSION}`. Note that while all architectures in the base system can be compiled by Clang, only a few architectures can be fully built by GCC." ], "previous_source": "", "target": [ "The FreeBSD base system also supports various versions of Clang and GCC as out-of-tree compilers. For large or risky changes, committers should do a test build with a supported version of GCC. Out of tree compilers are available as packages. GCC compilers are available as `${TARGET_ARCH}-gcc${VERSION}` packages, such as package:devel/freebsd-gcc14@aarch64[aarch64-gcc14]. Clang compilers are available as `llvm${VERSION}` packages, such as package:devel/llvm18[llvm18]. The project runs automated CI jobs to build everything with these compilers. Committers are expected to fix the jobs they break with their changes. Committers may test builds of userspace or individual kernels by setting `CROSS_TOOLCHAIN` to the package name, for example `CROSS_TOOLCHAIN=aarch64-gcc14` or `CROSS_TOOLCHAIN=llvm18`. For universe or tinderbox builds, `USE_GCC_TOOLCHAINS=gcc${VERSION}` builds all architectures using the appropriate GCC compiler packages. For universe or tinderbox builds using an out-of-tree Clang, pass `CROSS_TOOLCHAIN=llvm${VERSION}`. Note that while all architectures in the base system can be compiled by Clang, only a few architectures can be fully built by GCC." ], "id_hash": -982106677687790161, "content_hash": -982106677687790161, "location": "documentation/content/en/articles/committers-guide/_index.adoc:3259", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 877, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 155, "source_unit": "https://translate-dev.freebsd.org/api/units/1813180/?format=api", "priority": 100, "id": 1813180, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=725edb2e18e155af", "url": "https://translate-dev.freebsd.org/api/units/1813180/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2025-06-29T20:47:35.945061Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlescommitters-guide_index/en/?format=api", "source": [ "The FreeBSD project also has some CI pipelines on github. For pull requests on github and some branches pushed to github forks, a number of cross compilation jobs run. These test FreeBSD building using versions of Clang that lag the in-tree compiler by one or more major versions." ], "previous_source": "", "target": [ "The FreeBSD project also has some CI pipelines on github. For pull requests on github and some branches pushed to github forks, a number of cross compilation jobs run. These test FreeBSD building using versions of Clang that lag the in-tree compiler by one or more major versions." ], "id_hash": -959252698164358837, "content_hash": -959252698164358837, "location": "documentation/content/en/articles/committers-guide/_index.adoc:3263", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 100, "fuzzy": false, "translated": true, "approved": false, "position": 878, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 48, "source_unit": "https://translate-dev.freebsd.org/api/units/1813182/?format=api", "priority": 100, "id": 1813182, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlescommitters-guide_index/en/?checksum=72b00cc0dc14114b", "url": "https://translate-dev.freebsd.org/api/units/1813182/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2025-06-29T20:47:35.949174Z" } ] }