Commit Graph

17 Commits

Author SHA1 Message Date
Sergio Carlavilla Delgado 99333306b8 Handbook - Security: Upgrade the chapter
Upgrade Security chapter as part of the Handbook Working Group.
This is a first approximation, there are things to improve and
add to the chapter, but we can continue from here :)

Changes:
- Move VPN over IPSec to an article, in the future we will add too
  OpenVPN (DCO) and WireGuard to the article
- Rework Securing Accounts section
- Upgrade Password Hashes algorithms
- Improve sudo/doas section
- Add new Intrusion Detection System (IDS) section
- Add new Secure levels section
- Add new File flags section
- Rework OpenSSH and OpenSSL sections
- Rework Access Control Lists and add NFSv4 ACLs
- Add Capsicum introduction section
- Upgrade Resource Limits section
- Improve Asciidoc syntax

Documentation checked:
- https://man.freebsd.org/security
- https://calomel.org/ids_mtree.html
- https://calomel.org/openssh.html
- https://calomel.org/openssh_distributed.html
- https://man.freebsd.org/cgi/man.cgi?query=chflags&sektion=1&apropos=0&manpath=FreeBSD+13.2-RELEASE+and+Ports
- https://www.cyberciti.biz/tips/howto-write-protect-file-with-immutable-bit.html
- https://wiki.gentoo.org/wiki/Doas
- https://people.freebsd.org/~dannyboy/articles/freebsd_acls.pdf
- https://wiki.freebsd.org/NFSv4_ACLs
- https://man.freebsd.org/cgi/man.cgi?setfacl

Reviewed by:            emaste, karels, philip (first draft)
Differential Revision:  https://reviews.freebsd.org/D41620
Sponsored by:           Daifressh
2023-09-27 18:46:56 +02:00
Minsoo Choo 4bae012609 Update release engineering article to follow git workflow
Approved by:            gjb@ (re), carlavilla (doc)
Differential Revision:  https://reviews.freebsd.org/D41091
2023-08-01 10:27:39 +02:00
Graham Perrin 34058151ce 13.2R/ final countdown: corrections, improvements
Fix a handful of errors, some of which were noted in last year's bug
264113 for the /13.1R/ area but not fixed retrospectively.

Five commit message in underlying
https://github.com/freebsd/freebsd-doc/pull/165/commits

Not intended to be comprehensive, given the timescale;
https://reviews.freebsd.org/D39480#898747
draws attention to the absence of rtw88(4) from hardware notes, and
so on.

https://bugs.freebsd.org/264113

PR:                      264113
Approved by:             re (cperciva, gjb)
Pull request:            https://github.com/freebsd/freebsd-doc/pull/165
Differential revision:   https://reviews.freebsd.org/D39480
2023-04-10 20:54:18 +01:00
Graham Perrin b082a515f4 FreeBSD Status Report Process: fix URLs
https://docs.freebsd.org/en/articles/freebsd-status-reports-process/
– currently linked from
https://www.freebsd.org/status/
– is 404, not found. It's the FreeBSD Status Report Process
(Report, singular), not the FreeBSD Status Reports Process.

Fixes: 7cd49b34af freebsd-status-report-process: Add article
2023-03-11 20:03:48 +00:00
Lorenzo Salvadore 7cd49b34af
freebsd-status-report-process: Add article
Add a new article about the FreeBSD status report process created by
putting together content from
- website/content/en/status/_index.adoc;
- website/content/en/status/README (file is now removed);
- website/content/en/status/howto/_index.adoc (file is now removed).

Reviewed by:	status (pauamma)
Approved by:	doc (bcr)
Differential Revision: https://reviews.freebsd.org/D38919
2023-03-09 19:06:29 +01:00
Fernando Apesteguía 9587d12749 teams.adoc: Add Doceng's Secretary
Add name and email address as with other team's secretaries.
2022-10-07 12:45:08 +02:00
Sergio Carlavilla Delgado 4e2d74ce37 Add freebsd-accessibility@ to FreeBSD handbook mailing lists
PR:             263318
Submitted by:   PauAmma <pauamma (AT) gundo.com>
2022-05-03 22:46:29 +02:00
Sergio Carlavilla Delgado 0180441d7f Add slash at the end of the books and articles.
Reported by: @dbaio, rwatson@, John-Mark Gurney by email
2021-11-12 20:24:12 +01:00
Danilo G. Baio 12e79a273b handbook/eresources: Point SVN lists to their archives
Differential Revision:	https://reviews.freebsd.org/D32753
2021-11-06 08:20:46 -03:00
Sergio Carlavilla Delgado 64acd169b8 Build offline documentation using Hugo and other improvements
* Allow to build the documentation offline using Hugo
* Fix link problems
* Remove SVN entities
* Fix lang problems to help weblate
* Move all the AsciiDoctor translations to the shared folder to
  help weblate
* Allow the possibility to build each document. For example each
document can be edited in and watched the result in real time in
VS Code or Vim/NeoVim.

Breaking changes:

Eliminate the possibility of building books or articles.
They must be builded at the same time.
This functionality will be restored when version 0.89.0 is in the
repositories in a couple of weeks.

Reviewed by:            dbaio@
Differential Revision:  https://reviews.freebsd.org/D31926
2021-11-03 17:44:52 +01:00
Danilo G. Baio 9e45bdc5cf Remove references of old mailing lists
- freebsd-eol
- freebsd-lfs
- freebsd-tilera
- cvs-*

It covers only English documents.
2021-10-13 21:27:32 -03:00
Danilo G. Baio dde5a3e98d shared/*/mailing-lists: Remove variables for ctm-src-* lists
These languages don't reference anymore ctm-src-* lists.

There are still a few languages with outdated information which
references them:
  - el
  - fr
  - hu
  - it
  - mn
  - nl
  - ru
  - zh-cn
2021-10-13 20:52:47 -03:00
Danilo G. Baio 915f3a0fe5 Replace mailman-lists* variables with mailing-lists*
mailman-lists-desc --> mailing-lists-desc
mailman-lists-url  --> mailing-lists-url
mailman-lists      --> mailing-lists

Following mailing lists migration from Mailman to Mlmmj.
2021-10-13 20:03:08 -03:00
Danilo G. Baio 26089c882b Replace Mailman to Mlmmj addresses
Following mailing lists migration from Mailman to Mlmmj.

Reviewed by:	bapt
Differential Revision: https://reviews.freebsd.org/D32466
2021-10-12 17:42:45 -03:00
Danilo G. Baio 8ac1d42a58 website/docs/books: Sync documents list
Now reflecting all documents on
documentation/content/en/[articles|books].
2021-06-27 19:06:32 -03:00
Chris Rees a519c886a0 Remove trailing periods from mailing list names.
This makes them unusable in inline text.

While here, remove semicolon
2021-03-05 18:31:20 +00:00
Sergio Carlavilla Delgado 989d921f5d Migrate doc to Hugo/AsciiDoctor
I'm very pleased to announce the release of
our new website and documentation using
the new toolchain with Hugo and AsciiDoctor.

To get more information about the new toolchain
please read the FreeBSD Documentation Project Primer[1],
Hugo docs[2] and AsciiDoctor docs[3].

Acknowledgment:
Benedict Reuschling <bcr@>
Glen Barber <gjb@>
Hiroki Sato <hrs@>
Li-Wen Hsu <lwhsu@>
Sean Chittenden <seanc@>
The FreeBSD Foundation

[1] https://docs.FreeBSD.org/en/books/fdp-primer/
[2] https://gohugo.io/documentation/
[3] https://docs.asciidoctor.org/home/

Approved by:    doceng, core
2021-01-26 00:31:29 +01:00