Skip to content

docs: clean up documentation for open-source release#66

Merged
l50 merged 1 commit into
mainfrom
docs/open-source-cleanup
Apr 3, 2026
Merged

docs: clean up documentation for open-source release#66
l50 merged 1 commit into
mainfrom
docs/open-source-cleanup

Conversation

@l50
Copy link
Copy Markdown
Contributor

@l50 l50 commented Apr 3, 2026

Key Changes:

  • Rewrote and condensed the main README with clearer quick start, features, and structure
  • Added a new contributing guide for community collaboration
  • Updated provider, provisioning, and index docs for clarity and current architecture
  • Removed outdated and redundant olddocs and legacy instructions
  • Improved documentation navigation, metadata, and references for the new project direction

Added:

  • CONTRIBUTING.md with detailed guidelines for contributing code, labs, roles, and documentation
  • docs/mkdocs/docs/providers/vmware_windows.md covering VMware Workstation setup on Windows hosts

Changed:

  • README.md rewritten for brevity, clarity, and new project scope; added quick start, variant generator, and contributor acknowledgments
  • Documentation structure updated throughout docs/mkdocs/docs/index.md, docs/mkdocs/docs/provisioning.md, and provider docs for consistency and current best practices
  • Inventory tables in docs/domains-and-users.md simplified to focus on key host/domain roles
  • MkDocs config (docs/mkdocs/mkdocs.yml) updated with new site metadata, navigation, and social links
  • Validation guide (docs/validation.md) updated with clearer troubleshooting and AWS validation instructions

Removed:

  • All files in docs/olddocs/ including legacy install, troubleshooting, and provisioning instructions now superseded by current docs
  • Old architecture diagrams (aws.drawio, diagram.drawio) replaced by new SVGs in docs/
  • Outdated FQDN listing (docs/FQDNs.md) and redundant info

**Added:**

- Added `CONTRIBUTING.md` with contribution guidelines, code style, testing, and issue
  reporting instructions
- New provider guide for deploying on VMware Workstation from Windows hosts
  (`docs/mkdocs/docs/providers/vmware_windows.md`), including networking and
  Ansible setup

**Changed:**

- Refactored `README.md` to emphasize DreadGOAD-specific features, project
  differences from upstream GOAD, lab variants, quick start, and project
  structure; streamlined usage and installation instructions
- Updated `docs/domains-and-users.md` to simplify host/IP/domain tables and clarify
  that domain admin passwords are set at provisioning time
- Revised `docs/mkdocs/docs/index.md` to introduce DreadGOAD, highlight differences
  from upstream GOAD, and clarify vulnerability and safety warnings; added
  project acknowledgments
- Updated provisioning documentation (`docs/mkdocs/docs/provisioning.md`) to include
  Docker-based Ansible provisioning, explicit Vagrant management commands,
  disable/re-enable vagrant user instructions, and clearer playbook sequencing
- Updated `docs/validation.md` for improved instance ID redaction, troubleshooting,
  and script usage notes
- Updated `docs/mkdocs/mkdocs.yml`:
  - Changed site metadata to DreadGOAD and updated repo URLs
  - Added navigation for new VMware on Windows provider guide
  - Updated social links to point to DreadGOAD repo

**Removed:**

- Removed outdated documentation in `docs/olddocs/` and legacy provider install
  guides to reduce confusion and avoid duplication with new documentation
- Deleted `docs/FQDNs.md` and legacy architecture diagrams no longer referenced
@dreadnode-renovate-bot dreadnode-renovate-bot Bot added area/readme Changes made to README.md file area/docs Changes made to documentation labels Apr 3, 2026
@l50 l50 changed the title docs: update documentation for streamlined provisioning and provider setup docs: clean up documentation for open-source release Apr 3, 2026
@l50 l50 merged commit 1a38ce7 into main Apr 3, 2026
6 checks passed
@l50 l50 deleted the docs/open-source-cleanup branch April 3, 2026 15:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/docs Changes made to documentation area/readme Changes made to README.md file

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant