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
@generated is used by various tools to identify generated files.
For example, Phabricator will not display diffs in generated files
by default.
Reviewed by: gjb
Sponsored by: The FreeBSD Foundation
Differential Revision: https://reviews.freebsd.org/D28446
Add 'subs="attributes"' to [source] and [.programlisting] blocks
to properly replace variables in rendered output.
Sponsored by: Rubicon Communications, LLC ("Netgate")
Use the title of the book or article rather than the directory name
Also use the full name of the language, not just the short code
Sponsored by: Klara Inc.
Reviewed by: carlavilla
Differential Revision: https://reviews.freebsd.org/D28440
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
This ensures that `make all` will never try to run the internal server.
Instead, the user can run it manually if they need to.
Reviewed-by: gjb, hrs
Differential-Revision: https://reviews.freebsd.org/D28384
This instructs make(1) to consider them always out of date, and prevents
foot-shooting if a directory entry with the same name comes into existence.
Reviewed-by: gjb, hrs
Differential-Revision: https://reviews.freebsd.org/D28383
This ensures that the build still generally works if one specifies jobs and
multiple targets at the same time.
Reviewed-by: gjb, hrs
Differential-Revision: https://reviews.freebsd.org/D28382
The build should strive to not write to the shared space, so symlink these
back to the one copy and remove the prep work needed.
Reviewed-by: gjb, hrs
Differential-Revision: https://reviews.freebsd.org/D28381
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
