aboutsummaryrefslogtreecommitdiff
path: root/documentation/content/en/books/fdp-primer
Commit message (Collapse)AuthorAgeFilesLines
* fix inlined asciidoc code in en/books/fdp-primer/asciidoc-primerVladlen Popolitov2025-09-251-4/+0
| | | | | | Reviewed by: bcr Approved by: maxim (mentor) Differential Revision: https://reviews.freebsd.org/D52710
* Add HUGO_CMD variable for running on mac OSAndrés Jaimes2025-08-271-1/+1
| | | | | PR: 288591 Event: Oslo Hackathon 2025
* doc: Update source files (en .po), for translationsEdson Brandi2025-08-173-101/+248
|
* FDP - Structure: Updated Managing Contributor ListsJim Brown2025-08-131-12/+66
| | | | | | Reviewed by: ziaee@ Approved by: dbaio@, carlavilla@ Differential Revision: D49225
* FDP Primer - Translations: Add https to a linkVladlen Popolitov2025-08-121-1/+1
| | | | Differential Revision: D51711
* fdp/manual-pages: Reference style.mdoc(5)Mateusz Piotrowski2025-07-231-0/+1
|
* doc: Update source files (en .po), for translationsDanilo G. Baio2025-05-0118-1525/+1915
|
* fdp/writing-style: Improve subsectionsAlexander Ziaee2025-04-191-3/+3
| | | | | | | PR: 267428 Reviewed by: carlavilla, fernape, Jim Brown <jpb@jimby.name> Approved by: carlavilla (mentor) Differential Revision: https://reviews.freebsd.org/D49567
* Use proper spelling of AsciidoctorGraham Perrin2025-04-181-5/+4
| | | | | | | | Uncapitalize the 'd' in Asciidoctor as that is the proper spelling. While here, avoid some language like "editors for editing". PR: 273487
* fdp-primer: Add Managing Contributor Lists sectionJim Brown2025-03-021-3/+109
| | | | | Reviewed by: dbaio Differential Revision: https://reviews.freebsd.org/D49185
* [documentation]: Fix front matter "path" parameter.Fernando Apesteguía2025-02-1818-18/+36
| | | | | | | | "path:" parameter in the front matter was not documented and it has been deprecated in gohugo 0.144.0. Create a custom parameter with the same name in preparation for the upcoming update of www/gohugo to 0.144.1
* fdp-primer/overview: Update instructions for MacOSOlivier Cochard2025-01-251-9/+3
| | | | | Approved by: carlavilla Differential Revision: https://reviews.freebsd.org/D48681
* doc: Update source files (en .po), for translationsDanilo G. Baio2025-01-241-5/+5
|
* Upgrade copyright yearsSergio Carlavilla Delgado2025-01-071-4/+4
|
* Regenerate translation filesEd Maste2024-12-293-11/+11
| | | | | | | | Via `sh tools/update_translate_template.sh documentation` Reviewed by: dbaio Sponsored by: The FreeBSD Foundation Differential Revision: https://reviews.freebsd.org/D48234
* fdp-primer: Fix a typoMateusz Piotrowski2024-10-221-1/+1
|
* [fdp-primer]: Syntax and typo fixesFernando Apesteguía2024-09-221-2/+2
| | | | Reported by: pauamma
* macros: Disallow crossref without descriptionFernando Apesteguía2024-09-221-1/+1
| | | | While here, fix the macro documentation in fdp-primer.
* Fix links that use crossref without descriptionFernando Apesteguía2024-09-221-1/+1
| | | | | | | | | | | | | Summary: Add the anchor text to the crossref macro Test Plan: Apply patch and build the documentation A follow-up change will make the crossref macro fail if no description is used. Subscribers: delphij Differential Revision: https://reviews.freebsd.org/D46721
* doc: Update source files (en .po), for translationsDanilo G. Baio2024-09-142-106/+130
|
* [fdp-primer]: Clarify link macros usageFernando Apesteguía2024-09-071-1/+38
| | | | | | | | Put some order in what macros to use when. Follow-up for e6e9a81269 Differential Revision: https://reviews.freebsd.org/D46481
* [documentation]: Fix links in all output formatsFernando Apesteguía2024-09-071-1/+1
| | | | | | | | | | | | | Use the crossref: macro for intra-file and intra-book links. This will produce the correct link in Single HTML, Splitted HTML and PDF. Rework the macro to include the PDF special render. While here, briefly document macros. PR: 266107 Reviewed by: bcr@, dbaio@, concussious.bugzilla_runbox.com Differential Revision: https://reviews.freebsd.org/D46480
* fdp-primer: Remove emacs validation config for docbookMinsoo Choo2024-06-021-19/+0
| | | | | | | | FreeBSD Documentation project now uses asciidoctor instead of docbook. Also, the web link for the config cannot be reached. Reviewed by: Pau Amma <pauamma@gundo.com>, bcr, jrm Differential Revision: https://reviews.freebsd.org/D42753
* fdp-primer/editor-config: fix package URLs, and highlight the elisp coderilysh2024-03-241-2/+3
| | | | | | | | | | | | 1. There seem to be no package called vim-console or nano-devel in the ports tree, rather it's now just called vim or nano (depending on which one a user will install). 2. Highlight the emacs lisp syntax. Reviewed by: dbaio Pull Request: https://github.com/freebsd/freebsd-doc/pull/349 Signed-off-by: rilysh <nightquick@proton.me>
* fdp-primer/asciidoctor-primer: Adjust the headings exampleDanilo G. Baio2024-03-241-2/+2
| | | | | | | Trivial change level example for consistency with prior section. Submitted by: Matt Viverette - https://github.com/distancesprinter Pull Request: https://github.com/freebsd/freebsd-doc/pull/344
* documentation: Adjust path variables for Hugo 0.123.X upgradeDanilo G. Baio2024-03-2317-17/+17
| | | | | | | | These adjustments ensure menu and navigation will work fine with the recent changes. Reviewed by: fernape Differential Revision: https://reviews.freebsd.org/D44284
* doc: Update source files (en .po), for translationsDanilo G. Baio2024-01-172-5/+187
|
* FDP - Overview: Fix build pathGraham Perrin2023-10-071-1/+1
| | | | | PR: 274072 Differential Revision: https://reviews.freebsd.org/D42115
* FDP-Overview: Really fix the documentation pathSergio Carlavilla Delgado2023-09-251-1/+1
| | | | | PR: 274072 Submitted by: Graham Perrin <grahamperrin@gmail.com>
* FDP-overview: Fix build output pathSergio Carlavilla Delgado2023-09-251-1/+1
| | | | | PR: 274072 Submitted by: Graham Perrin <grahamperring@gmail.com>
* FDP: Add subsection about images and iconsSergio Carlavilla Delgado2023-09-201-0/+83
| | | | | | PR: 261847 Reviewed by: bcr@ Differential Revision: https://reviews.freebsd.org/D41775
* doc: Update source files (en .po), for translationsDanilo G. Baio2023-09-094-104/+115
|
* [fdp-primer]: Mention textproc/vale in man pages test sectionFernando Apesteguía2023-08-291-0/+12
| | | | textproc/vale can be used to check syntax for manual pages.
* fdp-primer: Revert .webp images to the original .png filesDanilo G. Baio2023-08-261-10/+10
| | | | | | | This adjustment is necessary due to an issue in the PDF files when including .webp images as embedded elements. Reported by: blackend
* FDP: Introduce how to use specific port for running hugo serverMinsoo Choo2023-07-221-2/+2
| | | | Differential Revision: https://reviews.freebsd.org/D41149
* Documentation: primer: AsciidoctorGraham Perrin2023-07-161-12/+12
| | | | | | | | Asciidoctor (not AsciiDoctor). Reviewed-by: carlavilla, salvadore Approved-by: carlavilla Pull-request: https://github.com/freebsd/freebsd-doc/pull/223
* doc: Update source files (en .po), for translationsDanilo G. Baio2023-07-152-58/+67
|
* FDP: Remove DocBook command and replace with AsciiDoc syntaxSergio Carlavilla Delgado2023-07-151-1/+1
| | | | | PR: 261815 Reported by: Pau Amma <pauamma@gundo.com>
* FDP: Remove Hugo version tip in overviewSergio Carlavilla Delgado2023-07-141-5/+0
| | | | | | | Remove Hugo version tip from GNU/Linux build section Hugo 0.90 is now two years old, we can safely remove this Sponsored by: Daifressh
* FDP: Upgrade MacOS build instructionsMinsoo Choo2023-07-141-5/+8
| | | | | | | - Upgrade MacOS build instructions - Remove tip about use Hugo 0.90 or higher Differential Revision: https://reviews.freebsd.org/D41036
* doc: Update source files (en .po), for translationsDanilo G. Baio2023-06-207-208/+1235
|
* fdp-primer: Add Weblate chapterDanilo G. Baio2023-06-198-77/+519
| | | | | | | | | | Based on the Wiki page https://wiki.freebsd.org/Doc/Translation/Weblate While here, adjust some old information in the po-translations chapter. Reviewed by: bcr, ebrandi, fernape, grahamperrin, pauamma_gundo.com Differential Revision: https://reviews.freebsd.org/D40313
* doc: Update source files (en .po), for translationsDanilo G. Baio2023-05-212-187/+214
|
* fdp-primer/writing-style: redo some parts of rev 2f4edf696bCeri Davies2023-05-111-4/+4
|
* vale/styles: Remove Weasel ruleMuhammad Moinur Rahman2023-05-111-7/+0
| | | | | | | | | | After some careful consideration and thoughts the Weasel rule is being removed because currently there are 18805 suggestions which will be really time consuming to fix as rewording the sentences from weasel words are a bit complicated. Approved by: bcr (mentor) Differential Revision: https://reviews.freebsd.org/D40063
* fdp-primer/editor-config: Correct typoLorenzo Salvadore2023-05-111-1/+1
| | | | | | | Remove an extra `+` that prevented an unsorted list from being rendered correctly. Approved by: doceng (blanket)
* fdp-primer/writing-style: Refactor after adding new Vale rulesMuhammad Moinur Rahman2023-05-041-29/+47
| | | | | | | | | | | | | | Over the last couple of day some new rules has been added, while some rules have been replaced with the one from Vale builtin engines and some have been removed. - Update the fdp-primer to reflect those changes. - As now there are mix of two different styles FreeBSD and Vale be more specific on naming those rules with dotted notation. - Reword the rule FreeBSD.ConsciousLanguage by avoiding sensitive words itself. Approved by: carlavilla (mentor) Differential Revision: https://reviews.freebsd.org/D39800
* fdp-primer/working-copy: Improve git installation instructionsLorenzo Salvadore2023-05-031-1/+1
| | | | | | | | - Describe the alternative between git and git-lite. - Use the package macro. Approved by: carlavilla (mentor) Differential Revision: https://reviews.freebsd.org/D39944
* fdp-primer: Add trademarksLorenzo Salvadore2023-05-032-3/+3
| | | | | | | | | | Add the FreeBSD and Git trademarks to the the trademarks list. Also forward commit 949582900fdaff5b8157a752fa8039a1887eba6c to book.adoc. Approved by: carlavilla (mentor) Differential Revision: https://reviews.freebsd.org/D39847
* fdp-primer/writing-style: improve English, and use own guidanceCeri Davies2023-04-251-35/+31
|