diff --git a/documentation/content/en/books/fdp-primer/structure/_index.adoc b/documentation/content/en/books/fdp-primer/structure/_index.adoc --- a/documentation/content/en/books/fdp-primer/structure/_index.adoc +++ b/documentation/content/en/books/fdp-primer/structure/_index.adoc @@ -143,95 +143,6 @@ This section contains specific notes about particular documents managed by the FDP. -=== Managing Contributor Lists - -The FreeBSD website recognizes contributors in several different lists on the website and in printed forms. -This section describes how the documentation team manages changes to these lists. - -==== Finding the Correct Files - -link:https://docs.freebsd.org/en/articles/contributors/[Contributors] to FreeBSD are maintained in article format. -The source file for managing the *Contributors* article file is located at: - -[subs=+quotes] ----- -doc - /documentation - /content - /{language} - /articles - /contributors - _index.adoc – Contains a list of include files that apply to each section. - _index.po – Translation page - contrib-develinmemoriam.adoc - content of “In Memoriam” section - contrib-develinmemoriam.po – Translation page ----- - -Copies of this contributors directory may exist in other content language directories. - -Note that the file "contrib-develinmemoriam.adoc" is also found in this directory. -See below for additional information. - -The *contributors/_index.adoc* file is designed as a collection of include files. -The include files are listed in the Hugo specific section of the source file. -The section is divided into several parts with "ifdef::" statements. -There is a sub-section for website output and one for non-website (including PDF) output. - -The text for each section of the *Contributors* page contains an "include::" statement. -For example, the entry for "Port Manager Alumni" is `include::{include-contrib-portmgralumni}[]`. -This pulls in the text for port manager alumni into the rendered output. - -To make a change, edit the appropriate include file: - -[subs=+quotes] ----- -include-contrib-committers: *~/doc/shared/contrib-committers.adoc* -include-contrib-corealumni: *~/doc/shared/contrib-corealumni.adoc* -include-contrib-develalumni: *~/doc/shared/contrib-develalumni.adoc* -include-contrib-portmgralumni: *~/doc/shared/contrib-portmgralumni.adoc* -include-contrib-additional: *~/doc/shared/contrib-additional.adoc* -include-contrib-386bsd: *~/doc/shared/contrib-386bsd.adoc* - -Also, edit the authors.adoc file: *~/doc/shared/authors.adoc* -and any related translations. - ----- - -In general, if a person is being added, there is only one edit necessary, and they can be added to the appropriate include file. -If a person is being moved from "current" to "alumni" status, two edits are required - one to remove and one to insert for the appropriate files. -The order of entries for all files is found in the table below. - -[cols="25%,25%,25%,25%", frame="none", options="header"] -|=== -| Purpose | Section Anchor | File in ~/doc/shared/ | Order Specification -| *FreeBSD Developers* | include-contrib-committers | contrib-committers.adoc | alphabetical order by last name -| *Core Team Alumni* | include-contrib-corealumni | contrib-corealumni.adoc | rough reverse chronological order -| *Development Team Alumni* | include-contrib-develalumni | contrib-develalumni.adoc | rough reverse chronological order -| *Ports Management Team Alumni* | include-contrib-portmgralumni | contrib-portmgralumni.adoc | rough reverse chronological order -| *FreeBSD Derived Software Contributors* | include-contrib-additional | contrib-additional.adoc | alphabetical order by first name -| *386BSD Patch Kit Patch Contributors* | include-contrib-386bsd | contrib-386bsd.adoc | alphabetical order by first name -| *Contributors to the central server project* | No include file used | contributors.adoc | unordered -| *Direct funding* | No include file used | contributors.adoc | unordered -| *Hardware contributors* | No include file used | contributors.adoc | unordered -| *Special contributors* | No include file used | contributors.adoc | unordered -|=== - -==== "In Memoriam" Section - -If the intent is to notify the BSD community of the death of a community member, the following procedures should be used: - -. Search the files above for the name, email address, and nickname (such as `foobsd`). -. Since the member is deceased (which should be double checked) remove the name from the appropriate file and add them to the "In Memoriam" file (*contrib-develinmemoriam.adoc* as noted above) by editing the appropriate files. -Try to find some additional information about their contributions to FreeBSD over the years and add it with their entry in the file. -This may require asking in the development mailing lists, contacting colleagues, contacting the FreeBSD Foundation, or searching though the commit logs. -. Where an email address is found with a name, remove the email address, but leave the name. - -[cols="25%,25%,25%,25%", frame="none", options="header"] -|=== -| Purpose | Section Anchor | File in ~/doc/documentation/content/{language}/articles/contributors/ | Order Specification -| *Development Team: In Memoriam* | contrib-develinmemoriam.adoc | contrib-develinmemoriam.adoc | rough reverse chronological order -|=== - [[structure-document-books]] == The Books: books/ @@ -347,3 +258,109 @@ [[intro]] == Introduction .... + +== Managing Contributor Lists + +The FreeBSD website recognizes contributors in several different lists on the website and in printed forms. +This section describes how the documentation team manages changes to these lists. + +=== Finding the Correct Files + +extref:{contributors}[Contributors] to FreeBSD are maintained in article format. +The source file for managing the *Contributors* article file is located at: + +[subs=+quotes] +---- +doc + /documentation + /content + /{language} + /articles + /contributors + _index.adoc – Contains a list of include files that apply to each section. + _index.po – Translation page + contrib-develinmemoriam.adoc - content of “In Memoriam” section + contrib-develinmemoriam.po – Translation page +---- + +Copies of this contributors directory may exist in other content language directories. + +Note that the file "contrib-develinmemoriam.adoc" is also found in this directory. +See below for additional information. + +The *contributors/_index.adoc* file is designed as a collection of include files. +The include files are listed in the Hugo specific section of the source file. +The section is divided into several parts with "ifdef::" statements. +There is a sub-section for website output and one for non-website (including PDF) output. + +The text for each section of the *Contributors* page contains an "include::" statement. +For example, the entry for "Port Manager Alumni" is `include::{include-contrib-portmgralumni}[]`. +This pulls in the text for port manager alumni into the rendered output. + +To make a change, edit the appropriate include file: + +[subs=+quotes] +---- +include-contrib-committers: *~/doc/shared/contrib-committers.adoc* +include-contrib-corealumni: *~/doc/shared/contrib-corealumni.adoc* +include-contrib-develalumni: *~/doc/shared/contrib-develalumni.adoc* +include-contrib-portmgralumni: *~/doc/shared/contrib-portmgralumni.adoc* +include-contrib-additional: *~/doc/shared/contrib-additional.adoc* +include-contrib-386bsd: *~/doc/shared/contrib-386bsd.adoc* + +Also, edit the authors.adoc file: *~/doc/shared/authors.adoc* +and any related translations. + +---- + +In general, if a person is being added, there is only one edit necessary, and they can be added to the appropriate include file. +If a person is being moved from "current" to "alumni" status, two edits are required - one to remove and one to insert for the appropriate files. +The order of entries for all files is found in the table below. + +[cols="25%,25%,25%,25%", frame="none", options="header"] +|=== +| Purpose | Section Anchor | File in ~/doc/shared/ | Order Specification +| *FreeBSD Developers* | include-contrib-committers | contrib-committers.adoc | alphabetical order by last name +| *Core Team Alumni* | include-contrib-corealumni | contrib-corealumni.adoc | rough reverse chronological order +| *Development Team Alumni* | include-contrib-develalumni | contrib-develalumni.adoc | rough reverse chronological order +| *Ports Management Team Alumni* | include-contrib-portmgralumni | contrib-portmgralumni.adoc | rough reverse chronological order +| *FreeBSD Derived Software Contributors* | include-contrib-additional | contrib-additional.adoc | alphabetical order by first name +| *386BSD Patch Kit Patch Contributors* | include-contrib-386bsd | contrib-386bsd.adoc | alphabetical order by first name +| *Contributors to the central server project* | No include file used | contributors.adoc | unordered +| *Direct funding* | No include file used | contributors.adoc | unordered +| *Hardware contributors* | No include file used | contributors.adoc | unordered +| *Special contributors* | No include file used | contributors.adoc | unordered +|=== + +=== "In Memoriam" Section + +If the intent is to notify the BSD community of the death of a community member, the following procedures should be used: + +. Search the files above for the name, email address, and nickname (such as `foobsd`). +. Since the member is deceased (which should be double checked) remove the name from the appropriate file and add them to the "In Memoriam" file (*contrib-develinmemoriam.adoc* as noted above) by editing the appropriate files. +Try to find some additional information about their contributions to FreeBSD over the years and add it with their entry in the file. +This may require asking in the development mailing lists, contacting colleagues, contacting the FreeBSD Foundation, or searching through the commit logs. +. Where an email address is found with a name, remove the email address, but leave the name. ++ +[cols="25%,25%,25%,25%", frame="none", options="header"] +|=== +| Purpose | Section Anchor | File in ~/doc/documentation/content/{language}/articles/contributors/ | Order Specification +| *Development Team: In Memoriam* | contrib-develinmemoriam.adoc | contrib-develinmemoriam.adoc | rough reverse chronological order +|=== ++ +. In the *~/doc/shared/authors.adoc* file, comment out (using one backslash '\') the email address to avoid creating the email link "mailto:" +See the example for `itojun` below: ++ +[source.programlisting,asciidoc] +.... +[shared/authors.adoc] + +[..] + +:itojun-name: Jun-ichiro Itoh +:itojun-email: \itojun@FreeBSD.org +:itojun: {itojun-name} <{itojun-email}> + +[..] +.... +