Add cross-reference table for treebase-servlet.xml pages vs documentation

[Copilot]

Cross-references URL mappings in treebase-servlet.xml against the "Pages to Account For" sections in the v3 UI/UX user story markdown files (doc/v3/*.md).

Summary

Results:

• Total URL mappings: 138
• Pages accounted for in user stories: 107
• Pages NOT in user stories: 32

Key undocumented pages include:

• Alternative search URL patterns (/searchForm.html, /searchStudy.html - different URL patterns from documented /search/studySearch.html)
• Some download endpoints (/search/downloadAStudy.html, /search/downloadATreeBlock.html, etc.)
• Tree parser functionality (/user/treeParser.html, /user/treeParserResult.html)
• JSON/API endpoints (/json/submissionIsland.html)
• Development/test pages (/test/testParser.html)

Changes Made

• Created doc/PAGE_CROSS_REFERENCE.md with comprehensive cross-reference table
• Updated doc/README.md to link to the new cross-reference document

Source Documents Analyzed

• treebase-web/src/main/webapp/WEB-INF/treebase-servlet.xml
• doc/v3/user-story-01-search.md
• doc/v3/user-story-02-account.md
• doc/v3/user-story-03-submission.md
• doc/v3/user-story-04-review.md
• doc/v3/user-story-05-admin.md
• doc/v3/user-story-06-technical.md
• doc/v3/user-story-07-governance.md

Original prompt

Crossreference between the pages listed in https://github.com/TreeBASE/treebase/blob/master/treebase-web/src/main/webapp/WEB-INF/treebase-servlet.xml and those accounted for in the markdown pages referenced in https://github.com/TreeBASE/treebase/tree/v3-ui-ux/doc/v3/README.md

Make a table to report all pages in the treebase-servlet.xml that are NOT in any of the markdown documents.

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[rvosa]

@copilot do NOT scan ALL the markdown documents anywhere in the repository!!!! Only the markdown files that sit within https://github.com/TreeBASE/treebase/tree/v3-ui-ux/doc/v3, i.e.:

• user-story-01-search.md
• user-story-02-account.md
• user-story-03-submission.md
• user-story-04-review.md
• user-story-05-admin.md
• user-story-06-technical.md
• user-story-07-governance.md

And then, specifically, on sections entitled something like Pages to Account For within those markdown documents. What I want is to know if the UI/UX user stories comport with the existing page structure.

[Copilot]

@copilot do NOT scan ALL the markdown documents anywhere in the repository!!!! Only the markdown files that sit within https://github.com/TreeBASE/treebase/tree/v3-ui-ux/doc/v3, i.e.:

• user-story-...

Updated the cross-reference in commit f192288 to analyze only the v3 user story documents (doc/v3/user-story-*.md), specifically their "Pages to Account For" sections.

Results:

• 138 total servlet URLs
• 99 pages covered in user stories
• 40 pages NOT in user stories

The undocumented pages include RSS feeds, legacy search pages, row segment operations, tree parser functionality, and JSON endpoints.

[rvosa]

@copilot What are 'legacy search pages'? How are they legacy with respect to the User Story documentation? Are they simply documented under their JSP extension or something?

[Copilot]

@copilot What are 'legacy search pages'? How are they legacy with respect to the User Story documentation? Are they simply documented under their JSP extension or something?

The term "legacy" was misleading. These are alternative URL patterns that exist in the servlet configuration alongside the documented ones.

For example:

• User Story 01 documents /search/studySearch.html
• The servlet also maps /searchStudy.html to searchStudyController

Both appear to serve search functionality but use different URL patterns. Updated terminology to "Alternative Search URL Patterns" in commit 1f2d196.

Whether these are truly legacy/deprecated or actively used alternatives would require further investigation.

[rvosa]

@copilot I have uploaded user-story-03-submission.md and user-story-06-technical.md. Please redo the analysis. Keep the overall structure of the report the same.

[Copilot]

@copilot I have uploaded user-story-03-submission.md and user-story-06-technical.md. Please redo the analysis. Keep the overall structure of the report the same.

Redid the analysis in commit 6fb4786 with the updated user-story-03-submission.md and user-story-06-technical.md.

Updated results:

• Pages accounted for: 107 (was 99)
• Pages NOT in user stories: 32 (was 40)

The updated user stories now include row segment pages (/user/matrixRowSegmentForm.html, /user/uploadRowSegmentData.html, etc.) and RSS/Atom feeds (/rss.xml, /feed.xml).