[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Missing code comments in guix source: 2 examples from gnu/services
From: |
Gábor Boskovits |
Subject: |
Re: Missing code comments in guix source: 2 examples from gnu/services |
Date: |
Mon, 5 Nov 2018 09:40:04 +0100 |
Hello,
swedebugia <address@hidden> ezt írta (időpont: 2018. nov. 5., H, 9:33):
>
> Hi
>
> Reading this
> http://git.savannah.gnu.org/cgit/guix.git/tree/gnu/services/monitoring.scm
>
> I would like to know what darkstat is without having to look elsewhere.
>
> None of the (define-s have docstrings and the top comment
>
> ;;;
> ;;; darkstat
> ;;;
>
> does not help much.
>
> prometheus-node-exporter-shepherd-service is just as little documented in the
> same file. From the file I have no idea what this does as its only
> documentation is:
>
> (shepherd-service
> (documentation "Prometheus node exporter.")
>
> ---
>
Thanks for pointing this out, I will fix this in prometheus-node-exporter.
Can you point me to a service where the documentation is statisfactory?
> http://git.savannah.gnu.org/cgit/guix.git/tree/gnu/services/admin.scm
>
> Is generally a little better documented with docstrings. But here a header
> like
>
> ;;;
> ;;; darkstat
> ;;;
>
> is missing for rottlog and also a short description of what rottlog does.
> (from the name and peeking at the code I'm guessing it rotates logs but many
> services have arbitrary names, especially to newcomers on GNU/Linux)
>
> --
> Cheers
> Swedebugia
Best regards,
g_bor