aboutsummaryrefslogtreecommitdiff
path: root/documentation/content/en/articles
Commit message (Collapse)AuthorAgeFilesLines
...
* committer-guide: Add an anchor for the how to land a github pull request ↵Warner Losh2021-06-161-0/+1
| | | | | | | | section. So I can start dropping it into chats when people ask :) Sponsored by: Netflix
* committers-guide: git always requires a clean tree to rebase.Warner Losh2021-06-161-1/+1
| | | | | | Remove confusing word. Sponsored by: Netflix
* committers-guide: fix thinko: this should be --ff-only to match elsewhereWarner Losh2021-06-161-1/+1
|
* Change Docbook to AsciiDoc in the contributing article.Warner Losh2021-06-161-1/+1
| | | | | | Also change ASCII to plain text to reflect more recent usage. Sponsored by: Netflix
* committers-guide: wordsmith the basics with the links a little.Warner Losh2021-06-151-4/+3
| | | | Sponsored by: Netflix
* comitter-guide: Add link to git for computer scientistsWarner Losh2021-06-151-0/+1
| | | | | | | | Add a link that I've shared with several people who found it useful to get a good mental model of git. It's written specifically for computer scientists. Sponsored by: Netflix
* committer-guide: Add link to migration articleWarner Losh2021-06-141-0/+1
| | | | | | | | Although the final commit in the old, legacy repo had excellent details on migration, this article has a few details that might also be helpful in migrating. Add it as an additional resource. Sponsored by: Netflix
* Improve English terms.Ceri Davies2021-06-133-3/+3
|
* Move the developer-centric bits from handbook/mirrors to committers-guideWarner Losh2021-06-111-1/+100
| | | | | | | | | The developer centric bits of how to interact with the project belong in the committer's guide, not in the handbook, so move it there. Reviewed by: gjb,debdrup Sponsored by: Netflix Differential Revision: https://reviews.freebsd.org/D30739
* [freebsd-releng]: s/shared/share where appropriateFernando Apesteguía2021-06-101-2/+2
| | | | | | Fix a couple of paths. Differential Revision: https://reviews.freebsd.org/D30489
* articles/committers-guide: remove 'work in progres' noteJason Helfman2021-06-091-5/+0
| | | | Reviewed by: imp@
* Remove an extra space after '+' charactersDanilo G. Baio2021-06-0815-157/+157
| | | | | | | | | | | | | 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
* contributors: move jlaffaye to developer alumniRene Ladan2021-06-072-1/+1
|
* articles/pgpkeys: Move eduardo's key to Developers sectionDanilo G. Baio2021-06-031-3/+3
|
* committers-guide: pull request landing tweaks.Warner Losh2021-06-031-2/+2
| | | | | | | | | | | Clarify that only closing the pull request resuires a GitHub account. All the other steps can proceed without one. Also, include --push-option=confirm-author in the push because pull requests will have a different author than the committer and this instructs the src pre-commit hooks to allow the commit through. Sponsored by: Netflix
* git: document how to merge a pull request from github.Warner Losh2021-06-031-0/+54
| | | | | | Reviewed by: ceri@, ygy@ Sponsored by: Netflix Differential Revision: https://reviews.freebsd.org/D30589
* articles/pgpkeys: Add a comment in the file about the workaround for PDF.Marc Fonvieille2021-05-311-0/+3
| | | | Reported by: ceri
* articles/pgpkeys: Add a workaround to fix the 1h build time for PDF.Marc Fonvieille2021-05-311-1/+1
| | | | | | | asciidoctor-pdf has issues with important number of lines leading to very long build time (more than 1 hour). The PGP keys are source of huge number of lines. As a quick workaround, a wrong path is used for the keys.
* Add a more obvious link to ref*/universe* machinesPhilip Paeps2021-05-241-0/+3
| | | | PR: 256109
* Link to the new pgpkeys.txt file in articles and booksSergio Carlavilla Delgado2021-05-231-1/+1
| | | | | | | | Link in articles and books to the new pgpkeys.txt file Remove all AsciiDoc syntax in pgpkeys.txt PR: 254636 Submitted by: dinoex@
* articles/[contributors,pgpkeys]: Correct include pathsCeri Davies2021-05-232-590/+596
| | | | | | | | 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)
* articles/contributors: Correct an incorrectly merged entryCeri Davies2021-05-231-1/+2
| | | | | | | | | 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)
* Replace references to svnadmin branchFernando Apesteguía2021-05-211-16/+3
| | | | | | | | In committers-guide, handbook and the new-account page in the website. There were references to the old `svnadmin` branch. Approved by: 0mp (mentor) Differential Revision: https://reviews.freebsd.org/D29922
* en/articles/*: Set includes paths according to the backend used for theMarc Fonvieille2021-05-1926-5/+311
| | | | | build. This fixes the PDF versions.
* committers-guide: Correct some paths for consistencyGuangyuan Yang2021-05-171-4/+4
|
* Update instructions on adding new committer entries.Ceri Davies2021-05-141-3/+2
| | | | Approved by: blackend (mentor)
* Add myself back into the current committers file.Ceri Davies2021-05-142-1/+1
| | | | | While here, remove myself from alumni, and update my PGP key. Approved by: blackend (mentor)
* articles/nanobsd: Fix broken linksDanilo G. Baio2021-05-131-1/+2
|
* phb: Change instructions for new ports.Mathieu Arnold2021-05-101-10/+16
|
* Point people to git-grep's man page directly.Mathieu Arnold2021-05-101-2/+2
| | | | | As we are talking about the tool and not an exact command to use, it feels more helpfull to give a link to the man page.
* Tell people how to use cp(1) to copy a port.Mathieu Arnold2021-05-101-0/+11
|
* committers-guide: Improve hyphenations and branch namesGuangyuan Yang2021-05-071-5/+5
| | | | Submitted by: gnn
* committers-guide: Update Gandi benefitsMateusz Piotrowski2021-05-061-2/+3
| | | | | | | Apart from some cosmetic changes, let's add a note that filling in the billing information first really speeds up the process. Reported by: Cédric Leroy <cedric.leroy@gandi.net>
* Improve SEO with the keywors meta tagSergio Carlavilla Delgado2021-05-0435-0/+36
| | | | | | 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
* contributors: Move kmoore, lifanov, and miwi to the alumni.Rene Ladan2021-05-042-3/+3
|
* Add committers entries for Charlie Li (vishwin)Charlie Li2021-05-022-0/+4
| | | | | | | Following section 7.1 in Committer's Guide. Approved by: arrowd (mentor), delphij (doc), ygy (doc) Differential Revision: https://reviews.freebsd.org/D30077
* Improve descriptions for some books and articlesAllan Jude2021-05-0221-22/+24
| | | | | | | | | | 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.
* Improve the SEO of the documentation portalSergio Carlavilla Delgado2021-05-0135-35/+38
| | | | | | | 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
* Add committers entries for Oskar Holmlund (oh)Oskar Holmlund2021-04-302-0/+4
| | | | | | | | Step 7.1.[1-4] in committers guide. Reviewed by: manu, br, delphij Approved by: manu (mentor) Differential Revision: https://reviews.freebsd.org/D29996
* Fix minor typo: s/Exteral/External/.Dimitry Andric2021-04-281-1/+1
|
* Add a first quick and dirty draft of what Git can do with GnuPG.Mathieu Arnold2021-04-271-0/+50
| | | | | Reviewed by: rene, imp, lwhsu Differential Revision: https://reviews.freebsd.org/D29726
* Add a short section about commit message for ports.Mathieu Arnold2021-04-271-0/+27
| | | | | Reviewed by: bapt Differential Revision: https://reviews.freebsd.org/D29994
* committers-guide: Remove confusing lineMateusz Piotrowski2021-04-261-1/+0
| | | | It is unclear what this line is referring to. Remove it.
* committers-guide: Do not use google as a verbMateusz Piotrowski2021-04-261-1/+1
|
* committers-guide: Merge duplicate policies into oneMateusz Piotrowski2021-04-261-1/+1
| | | | Those two points describe the same situation. Merge them into one point.
* committers-guide: Update list of files all committers may modifyMateusz Piotrowski2021-04-261-1/+1
| | | | The paths have changed after the switch to Git.
* committers-guide: Clean up commit bit types descriptionMateusz Piotrowski2021-04-261-1/+1
| | | | | | There is no need to mention explicitly that src committers may commit to the doc tree if they receive an appropriate approval. That's true for all the other committer types and trees.
* articles/committers-guide: fix typoCeri Davies2021-04-261-1/+1
|
* committer-guide: master->main rename in an example or twoWarner Losh2021-04-261-3/+3
| | | | | | | These instances of master or freebsd/master which should really be main. I did these examples against the old github mirror. Sponsored by: Netflix
* [committers-guide] Remove obsolete misc questionFernando Apesteguía2021-04-221-7/+0
| | | | | | | Adding files in Git does not requiere special considerations. Approved by: 0mp Differential Revision: https://reviews.freebsd.org/D29884