| Commit message (Collapse) | Author | Age | Files | Lines |
|
|
|
|
|
| |
PR: 281711
Reviewed by: dbaio
Differential Revision: https://reviews.freebsd.org/D49564
|
|
|
|
|
|
| |
Discussed with: mckusick, Deb Goodkin
Approved by: carlavilla (mentor)
Differential Revision: https://reviews.freebsd.org/D49407
|
|
|
|
|
|
|
|
|
|
| |
Memoriam dates should be in the format:
(start of commit bit - end of commit bit; RIP date deceased)
Fixes: b7652065 (In Memoriam: Hans Petter Selasky)
Reported by: mckusick
Approved by: mhorne (mentor)
Differential Revision: https://reviews.freebsd.org/D49404
|
|
|
|
|
|
|
|
| |
Discussed with: gallatin, imp
Reviewed by: dbaio, lwhsu
Approved by: gallatin
Approved by: carlavilla, mhorne (mentors)
Differential Revision: https://reviews.freebsd.org/D49215
|
| |
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
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
|
| |
|
|
|
|
|
|
| |
Chapter 11 of the FreeBSD Documentation Project Primer states that
language should be clear, short, and simple. This phrasing rarely helps
with that and can be cut to a single "to" in pretty much all instances.
|
| |
|
|
|
|
|
|
|
|
|
|
|
| |
Don't begin the article with the one and only section that is (much)
more than twelve years out of date.
Move the Donors gallery to the end. Improve it a little –
not forgetting a link out to The FreeBSD Foundation.
Approved by: doc (pauamma, carlavilla)
Differential revision: https://reviews.freebsd.org/D38796
|
| |
|
|
|
|
|
|
|
|
| |
Always use angle brackets around email addresses, not only for addresses
obtained from shared/authors.
Approved by: carlavilla, tcberner (mentor)
Differential Revision: https://reviews.freebsd.org/D36298
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
This helps the Weblate translation workflow and offline translations
through .po files, it's important to update these files constantly.
The goal here is to have a semi-automated translation workflow; Weblate
will pull updates automatically from the main repository and commit
translations to another repository.
Doc committers are encouraged to update the source .po files whenever
there are updates in the English documentation part.
$ ./tools/update_translate_template.sh documentation
Anyway, I'll keep doing this periodically.
Discussed with: doceng
|
|
|
|
|
|
|
|
|
|
| |
* Improve abstract
* Clarify that source tree make reference to all
FreeBSD source trees (src, ports and doc)
* Add a link to the current members of the Core Team
PR: 264411
Submitted by: grahamperrin@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
These files can be used by all languages, except
contrib-develinmemoriam.adoc.
- contrib-386bsd.adoc
- contrib-additional.adoc
- contrib-committers.adoc
- contrib-corealumni.adoc
- contrib-develalumni.adoc
- contrib-portmgralumni.adoc
Reviewed by: bcr, carlavilla
Differential Revision: https://reviews.freebsd.org/D32830
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
* 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
|
|
|
|
|
|
| |
This reverts commit 5e61a2d33757a272bb588427e7faf54ce778dd58.
joel's doc commit bit was reactivated.
|
| |
|
| |
|
| |
|
| |
|
|
|
|
|
|
|
|
| |
It corresponds to the 2nd step of the procedure described in section
7.1 of Committer's Guide.
Approved by: ygy (mentor)
Differential Revision: https://reviews.freebsd.org/D32133
|
|
|
|
|
|
| |
Missed entry in time; dates came from:
https://cgit.freebsd.org/doc/commit/?id=e8a9a5be4956739f3fd1f8d50a4b6bf5aeba5428
https://cgit.freebsd.org/doc/commit/?h=internal/admin&id=a50eb5c4872a34252c9cf9d2a95ad79e86b5ab70
|
| |
|
| |
|
| |
|
| |
|
|
|
|
| |
Fixes: 23d7fdd97095f97f51ac6a8844fd2cd3ec6dbacc
|
| |
|
|
|
|
| |
PR: 257692
|
|
|
|
|
|
|
|
| |
Section 7.1 in Committer's Guide
Reviewed by: tcberner
Approved by: tcberner (mentor)
Differential Revision: <https://reviews.freebsd.org/D31480>
|
| |
|
| |
|
|
|
|
|
|
|
| |
This reverts commit 3462d12db6ebf303064db168a2333374344f369a.
Too soon, it broke asciidoctor-pdf which doesn't know Hugo's shortcode.
It will take more time and care.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
This is a prerequisite for the translation workflow through .po files
and Weblate.
The asciidoctor include with the shortcode variable will help because
won't be needed to change the includes manually after converting the
translation (.po file) back to .adoc.
It will help other areas like, language attributes, which today is fixed
in every document.
The use of shortcode was suggested by jmooring@ from Hugo's project on
Github.
Reviewed by: carlavilla
Differential Revision: https://reviews.freebsd.org/D30823
|
|
|
|
|
|
|
|
|
|
|
|
|
| |
This is happening only on documentation/, basically in all places that
attaches a block or a paragraph to a list [1].
Although this is working, it impacts our translation tool po4a, the '+'
character is a difficult part when processing asciidoc[tor] files.
1 - https://docs.asciidoctor.org/asciidoc/latest/lists/continuation/#list-continuation
Reviewed by: carlavilla
Differential Revision: https://reviews.freebsd.org/D30688
|
| |
|
|
|
|
|
|
|
|
| |
A PDF build shows errors associated with incorrect include paths for
these articles, so fix them. Also update the guidance on adding a
pgpkey to the new required format.
Reported by: dbaio
Approved by: blackend (mentor)
|
|
|
|
|
|
|
|
|
| |
There is a single entry which refers to two individuals and with a
syntactically incorrect email address. This was incorrect and causing
issues with a PDF build of this article, so split it into two correct
entries, using information from our ppp(8) manpage.
Approved by: blackend (mentor)
|
|
|
|
|
| |
build.
This fixes the PDF versions.
|
|
|
|
|
| |
While here, remove myself from alumni, and update my PGP key.
Approved by: blackend (mentor)
|
|
|
|
|
|
| |
Add in all articles and books the tag list.
Modify the theme to use the tag list defined in articles and books
to generate the keywords meta tag
|
| |
|
|
|
|
|
|
|
| |
Following section 7.1 in Committer's Guide.
Approved by: arrowd (mentor), delphij (doc), ygy (doc)
Differential Revision: https://reviews.freebsd.org/D30077
|
|
|
|
|
|
|
|
|
|
| |
Also add weights to some, to define the sort order in the index
Put the more commonly used items at the top of their respective lists
The improved descriptions were taken from the old books/articles list:
https://www.freebsd.org/docs/books/
Sponsored-By: Klara Inc.
|
|
|
|
|
|
|
| |
Changes:
- Add the description meta tag in the index, articles and books
- Add a brief description in each article and book.
- Remove the SVN expansion tag
|
|
|
|
|
|
|
|
| |
Step 7.1.[1-4] in committers guide.
Reviewed by: manu, br, delphij
Approved by: manu (mentor)
Differential Revision: https://reviews.freebsd.org/D29996
|
|
|
|
|
|
| |
bits have been safe kept.
Approved by: core (with core-secretary@ hats on)
Differential Revision: https://reviews.freebsd.org/D29705
|
| |
|
| |
|