git: 691c574c56c4 - main - sysutils/helm-docs: New port

Kenneth Raplee <[email protected]>
Newsgroups gmane.os.freebsd.devel.cvs.ports
Message-ID <[email protected]>
The branch main has been updated by kenrap:

URL: https://cgit.FreeBSD.org/ports/commit/?id=691c574c56c433a75ef54e2e0b39aa72b61e732f

commit 691c574c56c433a75ef54e2e0b39aa72b61e732f
Author:     Hywel Andrews <[email protected]>
AuthorDate: 2026-08-18 23:04:36 +0000
Commit:     Kenneth Raplee <[email protected]>
CommitDate: 2026-08-19 08:31:33 +0000

    sysutils/helm-docs: New port
    
    A tool that auto-generates documentation from helm charts into markdown
    files. The resulting files contain metadata about their respective chart
    and a table with each of the chart's values, their defaults, and an
    optional description parsed from comments.
    
    PR:             297599
    Approved by:    arrowd (co-mentor)
---
 sysutils/Makefile            |  1 +
 sysutils/helm-docs/Makefile  | 30 ++++++++++++++++++++++++++++++
 sysutils/helm-docs/distinfo  |  5 +++++
 sysutils/helm-docs/pkg-descr | 10 ++++++++++
 4 files changed, 46 insertions(+)

diff --git a/sysutils/Makefile b/sysutils/Makefile
index a7081b73cbea..c82eed840967 100644
--- a/sysutils/Makefile
+++ b/sysutils/Makefile
@@ -516,6 +516,7 @@
     SUBDIR += healthd
     SUBDIR += heirloom
     SUBDIR += helm
+    SUBDIR += helm-docs
     SUBDIR += helmfile
     SUBDIR += herbe
     SUBDIR += hexpeek
diff --git a/sysutils/helm-docs/Makefile b/sysutils/helm-docs/Makefile
new file mode 100644
index 000000000000..0362c76e0b66
--- /dev/null
+++ b/sysutils/helm-docs/Makefile
@@ -0,0 +1,30 @@
+PORTNAME=	helm-docs
+DISTVERSIONPREFIX=	v
+DISTVERSION=	1.14.2
+CATEGORIES=	sysutils
+
+MAINTAINER=	[email protected]
+COMMENT=	Automatically generate markdown documentation from helm charts
+WWW=		https://github.com/norwoodj/helm-docs
+
+LICENSE=	GPLv3
+
+USES=		go:modules
+
+USE_GITHUB=	yes
+GH_ACCOUNT=	norwoodj
+
+GO_MOD_DIST=	github
+GO_MODULE=	github.com/norwoodj/helm-docs
+GO_TARGET=	./cmd/${PORTNAME}
+
+PLIST_FILES=	bin/${PORTNAME}
+PORTDOCS=	README.md
+
+OPTIONS_DEFINE=	DOCS
+
+do-install-DOCS-on:
+	${MKDIR} ${STAGEDIR}${DOCSDIR}
+	${INSTALL_DATA} ${WRKSRC}/${PORTDOCS} ${STAGEDIR}${DOCSDIR}/
+
+.include <bsd.port.mk>
diff --git a/sysutils/helm-docs/distinfo b/sysutils/helm-docs/distinfo
new file mode 100644
index 000000000000..c4dbf6c2a090
--- /dev/null
+++ b/sysutils/helm-docs/distinfo
@@ -0,0 +1,5 @@
+TIMESTAMP = 1787073088
+SHA256 (go/sysutils_helm-docs/norwoodj-helm-docs-v1.14.2_GH0/go.mod) = dcd4c3ab4b81c124a47bd941580492cd2ecd34808b3e8b727be095ad5fec3089
+SIZE (go/sysutils_helm-docs/norwoodj-helm-docs-v1.14.2_GH0/go.mod) = 1581
+SHA256 (go/sysutils_helm-docs/norwoodj-helm-docs-v1.14.2_GH0/norwoodj-helm-docs-v1.14.2_GH0.tar.gz) = 88d1b3401220b2032cd27974264d2dc0da8f9e7b67a8a929a0848505c4e4a0ae
+SIZE (go/sysutils_helm-docs/norwoodj-helm-docs-v1.14.2_GH0/norwoodj-helm-docs-v1.14.2_GH0.tar.gz) = 109180
diff --git a/sysutils/helm-docs/pkg-descr b/sysutils/helm-docs/pkg-descr
new file mode 100644
index 000000000000..f84b545514d1
--- /dev/null
+++ b/sysutils/helm-docs/pkg-descr
@@ -0,0 +1,10 @@
+The helm-docs tool auto-generates documentation from helm charts into markdown
+files. The resulting files contain metadata about their respective chart and a
+table with each of the chart's values, their defaults, and an optional
+description parsed from comments.
+
+The markdown generation is entirely gotemplate driven. The tool parses metadata
+from charts and generates a number of sub-templates that can be referenced in a
+template file (by default README.md.gotmpl). If no template file is provided,
+the tool has a default internal template that will generate a reasonably
+formatted README.
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.