Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Jan 7, 2026

The root directory contained 9 scattered markdown files with significant redundancy and unclear organization. This consolidates and structures the documentation.

Changes

Root cleanup

  • Removed all markdown files except README.md from root
  • Updated README.md with organized documentation links

New structure: doc/

  • development/ - Build and deployment guides
    • BUILDING.md - Consolidated build instructions
    • DEPLOYING.md - Deployment procedures with DWR integration notes
  • technical-notes/ - Implementation details
    • DWR.md - Direct Web Remoting Spring 5 compatibility
    • UPGRADES.md - Consolidated SLF4J, Jersey 2.x, and JUnit 4 migrations (merged from 4 separate files: DEPLOYMENT_FIX_ANALYSIS.md, FIX_SUMMARY.md, JERSEY_2X_UPGRADE.md, JUNIT4_MIGRATION.md)
  • archive/ - Deprecated TreeBASE v.1 migration procedures
    • INSTALL.md - Data loading environment (marked deprecated)
    • LOADING.md - Nexus file import (marked deprecated)
  • README.md - Navigation guide

Content improvements

  • Eliminated duplication across 4 fix/analysis documents
  • Added deprecation notices to archived v.1 migration docs
  • Updated all internal cross-references
  • Removed outdated deployment workaround instructions
Original prompt

In the root there is a proliferation of *.md files. Clean these up:

  • only keep README.md in the root
  • move all others to doc/
  • check the documents for accuracy and consistency
  • remove all old, deprecated information
  • structure the *.md files in a logical set
  • carry info over from one to the other if you have to
  • if need be, link between the files

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Co-authored-by: rvosa <106490+rvosa@users.noreply.github.com>
Copilot AI changed the title [WIP] Clean up *.md files by moving and organizing Reorganize markdown documentation into structured doc/ directory Jan 7, 2026
Copilot AI requested a review from rvosa January 7, 2026 19:41
@rvosa rvosa marked this pull request as ready for review January 7, 2026 19:49
@rvosa rvosa merged commit eb36f40 into master Jan 7, 2026
3 checks passed
@rvosa rvosa deleted the copilot/clean-up-markdown-files branch January 7, 2026 19:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants