17 Commits
Author SHA1 Message Date
Thomas Vincent 57b8088e13 docs: comprehensive validation audit, Spine poller overhaul, and technical refactor (#229)
* docs: comprehensive audit, Spine poller overhaul, and technical refactor

- Overhaul Spine documentation (Spine.md) with complete end-to-end guide: architecture, prerequisites for modern distros (EL8/9 CRB, Ubuntu 22/24, Debian 11/12, FreeBSD), SUID root permissions, secure spine.conf setup (0640), Web UI configuration (Paths, Poller type, Data Collectors tuning), MySQL max_connections sizing, and troubleshooting.
- Fix broken links and anchors (Hardening, SNMP data queries, Hook API references).
- Fix broken image reference in Sites.md (add-site.JPG -> add-site.png).
- Fix syntax errors in documentation PHP code blocks, including invalid parenthesization, missing SQL execute quotes, and malformed comments in FAQ.
- Fix DevOps installation commands: use config.php.dist, correct systemctl service names for MySQL/MariaDB/PHP-FPM, remove nonexistent php-json, add missing composer install, and correct Debian/Ubuntu systemd environment path.
- Correct grammatical errors, repeated words, and typos across all markdown documents.
- Remove obsolete unreferenced duplicate installation guides.

Signed-off-by: Thomas Vincent <thomasvincent@gmail.com>

* docs: correct reviewed examples and guidance

Signed-off-by: Thomas Vincent <thomasvincent@gmail.com>

* docs: correct guidance that disagrees with the Cacti source

Verified each claim against include/global_arrays.php, lib/auth.php,
lib/functions.php, host_templates.php and the Spine config parser. The
notable ones: api_plugin_safe_exec() does not exist on either branch,
Spine reads DB_Pass rather than DB_Password, and the CDEF special data
source table was missing five entries and renamed four others.

Signed-off-by: Thomas Vincent <thomasvincent@gmail.com>

* docs: wrap Spine prose and fence the connection sizing formula

The formula's bare asterisks rendered as emphasis, dropping the multiplication signs.

Signed-off-by: Thomas Vincent <thomasvincent@gmail.com>

* chore: refresh copyright year in scripts and issue templates

Signed-off-by: Thomas Vincent <thomasvincent@gmail.com>

---------

Signed-off-by: Thomas Vincent <thomasvincent@gmail.com>
2026-09-08 09:41:21 -04:00
TheWitness 660f054809 QA: Update Copyrights 2025-11-18 17:01:31 -05:00
TheWitness 08efd1fa30 QA: Updating Copyrights to 2024 2024-03-16 05:04:49 +05:30
netniV bcf42c883b Remove debugging commands from build script 2023-09-05 00:13:36 +00:00
netniV f36d471bc2 Fix up build script wildcard handling 2023-09-04 23:52:58 +00:00
Mark Brugnoli-Vinten 5b637afcf2 Script updates 2023-07-22 23:13:45 +01:00
netniV ff26d0693b Update missing link script 2023-02-27 13:54:51 +00:00
Mark Brugnoli-Vinten 80be2916f5 Update copyright year for 2023 2023-01-03 23:43:28 +00:00
netniV 3523d40a4e Fixing up style issues for PR #43 2019-04-11 07:29:33 +00:00
netniV de2b59ad7e Set HTML5 title with 'Cacti - ' prefix 2019-03-30 19:38:39 +00:00
netniV 06e1273414 Update build script to use bash instead of sh 2019-01-20 15:10:06 +00:00
netniV 747e03a4ee Update Contributing.md 2018-10-27 13:44:11 +00:00
Tony Roman 506ccbef0c Bash syntax in sh define shell script, fixed 2018-10-23 20:18:03 -04:00
Tony Roman f9ca6d63e0 Fix up build process
- Fixed build script to correctly detect pandoc and lua requirements
 - Fixed lua script syntax
2018-10-05 11:22:59 -04:00
Tony Roman 37196a02c0 Initial documentation html build script
- Build script using `pandoc` with custom CSS to generate
   standalone HTML5 files
 - Git ignore the `html` output directory
 - TODO: Figure out how to get rid of `pandoc` warnings about titles
2018-10-01 13:10:26 -04:00
Tony Roman b101b10f22 Move check link script into bin directory 2018-09-30 20:58:20 -04:00
Tony Roman 4a599ea7b9 Move scripts into bin directory 2018-09-30 20:48:59 -04:00