diff --git a/website/content/en/internal/developer.adoc b/website/content/en/internal/developer.adoc index 43cc11fe27f1..99e7e727a372 100644 --- a/website/content/en/internal/developer.adoc +++ b/website/content/en/internal/developer.adoc @@ -9,21 +9,24 @@ include::shared/en/urls.adoc[] == link:{committers-guide}[Committers Guide] -This document is an overall guide for all new committers, including both technical details and policy details. For the former, see the chapters on link:{committers-guide}#git-primer[the Git VCS], the link:{committers-guide}#bugzilla[Bugzilla] bug tracking system, and the link:{committers-guide}#ssh.guide[SSH Quick-Start Guide]. +This document is an overall guide for all new committers, including both technical details and policy details. +For the former, see the chapters on link:{committers-guide}#git-primer[the Git VCS], the link:{committers-guide}#bugzilla[Bugzilla] bug tracking system, and the link:{committers-guide}#ssh.guide[SSH Quick-Start Guide]. -It contains almost everything a new committer to the FreeBSD Project needs to know. See the Documentation Project Primer and the Ports Guide, below, for more info. +It contains almost everything a new committer to the FreeBSD Project needs to know. +See the Documentation Project Primer and the Porter's Handbook for more info. == link:{fdp-primer}[FreeBSD Documentation Project Primer for New Contributors] -This primer covers everything you will need to know in order to start contributing to the FreeBSD Documentation Project, from the tools and software you will be using (both mandatory and recommended) to the philosophy behind the Documentation Project. +Everything you will need to know to start contributing to the Project – from mandatory and recommended software, to the philosophy behind the Project. -== link:{porters-handbook}[FreeBSD Porter's Handbook] +=== link:{fdp-primer}doc-build/#doc-build-rendering-html[Rendering to HTML] -A guide for FreeBSD ports committers. This includes the canonical link:{porters-handbook}#versions[Table of __FreeBSD_version Values]. +Using the Git repository to update and build the pages. -== link:{fdp-primer}#the-website-build[How to build the FreeBSD Web Pages]. +== link:{porters-handbook}[FreeBSD Porter's Handbook] -This document describes how to build and update the FreeBSD Web pages from the Git repository by hand. +A guide for FreeBSD ports contributors and committers. +This includes the canonical link:{porters-handbook}#versions[Table of `__FreeBSD_version` Values]. == FreeBSD Projects