Since 10.3-RELEASE has gone EOL a while ago, update instructions to
match the newest -RELEASE on the newest releng branch as of writing.
While here, also correct at typo that instructed people to look in
/usr/shared which doesn't exist in hier(7).
Generally things are done by consensus, with the core team stepping in when
there's a dispute. Update the documented encumbered software policy to reflect
what's actually done and is considered to be working. This harmonizes the wording
for contributed software and encumbered software. Also wordsmith how Release
Engineering is referenced. Also removes stray > marks on object files. Also
document the fw files.
Note: the ascii file requierment dates from CVS days and should change. But
I've not pushed things that far in this commit.
Get the sections rendering correctly in hugo
Convert markdown enumerated list convention to asciidoc
Remove stray '+' lines
Small tweak in wording missed in review for this content's new context
Do the easy git updates for URLs and branch names. Note svn guide
is just for ports (but don't edit out the src specific bits
since we'll dump it wholesale in 2 months). Add pointer to my
draft docs until they can all be integrated.
Now that subversion is gone, replace the subversion info with git info.
Note: This was pulled in from my github repo. Fixes contributed
by jrm@, uqs@, woodsb02@, delphij@, rpokala@ and ceri@
Reviewed by: emaste@ (earlier version, conditional), gjb@
Differential Revision: https://reviews.freebsd.org/D28474
Add 'subs="attributes"' to [source] and [.programlisting] blocks
to properly replace variables in rendered output.
Sponsored by: Rubicon Communications, LLC ("Netgate")
Remove unnecessary step when the user install
the required tools for the website and documentation.
There's no need to move the shared folder between projects
Summary: Really simple typo, good change to test the new workflow.
Test Plan: None
Reviewers: carlavilla
Reviewed By: carlavilla
Differential Revision: https://reviews.freebsd.org/D28348
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
