Re: Documentation portal schedule

On dic 11 11:03, Sergio Carlavilla wrote: > Hi again, > > Sorry, I used my personal account instead of the FreeBSD account. > > Finally I made only one commit with all the new documentation portal. > > So the new schedule it's: > > 1º 11:00 am - Spanish time. Make the commit with the new Docum

Re: FreeBSD Documentation Portal status and review request

On dic 04 0:30, Sergio Carlavilla wrote: > Hi to all and thanks for your feedback :) Hi :)! > Rocky Hotas: > > > - A dark theme would be very useful (and also very cool!). > > Just uploaded, also a high contrast theme too. Take a look and let me > know your toughts :)

Re: FreeBSD Documentation Portal status and review request

On nov 23 1:07, Pau Amma wrote: [...] > I haven't looked at it yet, but I need high-contrast and I'm sure others do. > If you or someone need lower contrast (see above, photophobia), maybe a > separate theme for that? (I have no idea how much work goes into creating > one, so feel free to ignore

Re: FreeBSD Documentation Portal status and review request

On nov 21 17:31, Sergio Carlavilla wrote: [...] > For example a local search using Algolia[2] as Hugo[3] or > AsciiDoctor[4] does. Algolia provides a free version for Open Source > projects[5]. > And the dark theme. > > Apart from that, you can see the new Documentation Portal here[6]. First, t

mdoc macro to mention packages in manpages

Hello! It seems that the current manpages do not use a standard, uniform way to mention a package/port name. I'm not very skilled about mdoc(7), but after some `zgrep' in /usr/share/man/man* (as suggested in par. `10.3.5. Important Macros' in the Handbook), I found several different solutions. De

Re: Use make to only build new files in the documentation

On nov 14 16:14, Jindong Li wrote: > hmm guys i'm kind of new to this, if I was going to apply this change > (since it appears already committed?), what would I need to do? :) I'm not sure I understood what you mean. Did you modify a file of the documentation in your local repository? If this is t

Re: Use make to only build new files in the documentation

On nov 14 19:46, Sergio Carlavilla wrote: > > Hi Rocky, > > You have two options here. > > First option is to build the documentation only with one language. > For example, to build only the english language use: > > make run DOC_LANG="en" > > In the second option you can go to the folder of t

Use make to only build new files in the documentation

Hello! Chapter 5 of the ``FreeBSD Documentation Project Primer for New Contributors'' shows how to build documentation: I tried several consecutive times to run `make' for the `documentation' (not the `website'), but each time it builds a

Editors configuration with AsciiDoc?

Hello! In the current Documentation primer, the suggested configuration for Emacs seems to be still related to DocBook. The same for vim. I understand that this is a work-in-progress and that the transition to AsciiDoc is maybe

Re: Interested in helping with documentation

Hello! > Sent: Saturday, July 07, 2018 at 8:17 PM > From: "Eitan Adler" > To: Sid > Cc: "freebsd-doc@freebsd.org" > Subject: Re: Interested in helping with documentation [...] > I will also echo that > the documentation committers are understaffed. I'm sorry for that. I tried to do a contrib

Revision of LDAP server section of Handbook

Hello! As in the subject, about this revision: https://reviews.freebsd.org/D10600 (full update of OpenLDAP server installation and configuration procedure on FreeBSD) The just submitted new version of the patch tries to provide style uniformity and conciseness to the whole text. All the previous

Re: Review of a handbook patch

Hi! > Sent: Friday, July 27, 2018 at 2:21 AM > From: "Benjamin Kaduk" > To: "Rocky Hotas" > Cc: d...@freebsd.org > Subject: Re: Review of a handbook patch [...] > Hopefully this helps. Thank you for submitting the patch and updating it > so much,

Review of a handbook patch

Hi! This is about the review: https://reviews.freebsd.org/D10600 (patch to LDAP section of the FreeBSD Handbook) I wrote the text as a newbie, enthusiast user who tried to install an OpenLDAP server, found some difficulties, and wanted to contribute. The style was naive and needed several correc

Re: NFS documentation addition

Dear Mattew, > Sent: Thursday, May 25, 2017 at 2:11 PM > From: "Matthew Kelly" > To: freebsd-doc@freebsd.org > Subject: NFS documentation addition > [...] > So I would like to see that section of the handbook modified to either > explicitly state that they have to be restarted in the right order

Re: FreeBSD Handbook - LDAP section

Hi! > Sent: Thursday, May 04, 2017 at 1:28 AM > From: "Benjamin Kaduk" > To: "Rocky Hotas" > Cc: freebsd-doc@freebsd.org > Subject: Re: FreeBSD Handbook - LDAP section > > Bug reports are fine, but you could also create an (account and) > entry o

FreeBSD Handbook - LDAP section

Hi! This section about LDAP of the FreeBSD Handbook https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/network-ldap.html is outdated and with several errors. For the first half, the structure of the guide can be preserved, but the remainder needs a complete rearrangement. There are also

PAM Documentation

Hello! I would like to signal some issues in the FreeBSD PAM Documentation, available at link: https://www.freebsd.org/doc/en_US.ISO8859-1/articles/pam/ 1) Even if maybe PAM isn't so often updated, this guide is "Copyright © 2001-2003", so maybe too much old. 2) Chapters 6 and 7 are blank. 3) S