Normalization Notes

MASTER NORMALIZATION NOTES

Direct Answer

This page documents editorial and structural normalization rules used to prepare Botway documentation for human readers and machine retrieval. Use it as the quality-control reference for future doc updates.

Citations

• Markdown reference: https://spec.commonmark.org/
• NY Department of State: https://dos.ny.gov/

See Also

• Knowledge Base
• Glossary
• NY Compliance Package

What Was Standardized

1. Heading Hierarchy: All sections normalized to a consistent depth structure. Document-level headers (H1 for master title, H2 for major sections, H3 for subsections, H4 for terms/articles). Source documents used inconsistent heading levels; all have been aligned.

2. Tone Discipline: Marketing language, promotional phrasing, and calls to action removed from all sections. Conversational tone replaced with analytical, operator-focused language throughout. Phrases such as "contact us," "schedule a consultation," and similar CTAs were eliminated.

3. Jurisdiction Labeling: Every major section and article now includes explicit jurisdiction tagging (New York State, NYC, Federal, General). Source documents were inconsistent in jurisdiction attribution; all have been standardized.

4. Terminology Normalization: Consistent use of terms across all documents. Where the Glossary and Playbook documents used different terms for the same concept, the Glossary definition was treated as authoritative. Examples: "earnest money" vs. "contract deposit" (both retained with cross-reference); "attorney review" terminology standardized.

5. LLM Summary Entries: Appended to each major section. The Landlord Playbook source already contained per-article LLM Summary Entries (41 entries for 50 articles). The Seller Playbook contained a single consolidated LLM Summary Entry. The Compliance Package and Fair Housing sections had no LLM entries; these were generated during compilation.

6. Citation Markers: Source glossary entries contained citeturnXsearchX citation markers from the original research compilation. These have been removed as they are not functional in the published format.

What Was Merged

1. Glossary Sources: Four source glossaries (Transaction & Leasing; Finance & Investment; Development, Zoning & Construction; Title, Closing, Governance & Regulation) were previously merged into the Master Glossary with 23 duplicates resolved. This compilation preserves the merged result.

2. Compliance Content: The NY Compliance Package was extracted from the Developer Specification document (which contained site architecture, meta templates, JSON-LD schemas, and launch checklists alongside compliance content). Only the compliance-relevant content was extracted and restructured into the nine-section format specified for Section IV. Developer-facing specifications (tech stack, CMS frontmatter, HTML head templates, JSON-LD schemas, robots.txt, sitemap configuration, launch checklists) were excluded as they are implementation artifacts, not knowledge base content.

3. Fair Housing Content: Fair housing documentation was extracted from both the compliance outline (Section 5.4) and relevant Glossary entries. Content was consolidated into the eight-section format specified for Section V, with no duplication of content already present in Section IV.

4. Seller Playbook Supplements: Article 4 expanded advertising content and Property-Specific Due Diligence items were appended as supplements to the main 50-article seller playbook, clearly labeled as supplemental material.

What Was Clarified

1. PCDA $500 Credit: The 2024 amendment eliminating the $500 credit option is noted in both the Compliance Package and Glossary. Source documents were consistent on this point.

2. Duplicate Glossary Entries: Several entity-formatted entries (e.g., ``) appeared alongside standard entries for the same terms (e.g., ACRIS). The entity-format duplicates were removed; the standard entries were retained.

3. Seller vs. Landlord Playbook Structure: The Landlord Playbook uses a consistent 10-section article format with per-article LLM Summary Entries. The Seller Playbook uses a similar but not identical structure (some articles omit certain sections). This structural variation is preserved rather than artificially forced into uniformity, as article content dictates appropriate section inclusion.

Structural Conflicts Resolved

1. Heading Depth Conflict: Source Glossary used H2 for category sections and H3 for terms. Source Playbooks used H1 for article titles and H2 for article sections. Within the unified document, these have been shifted to maintain consistent hierarchy under the master document's H2 section headers.

2. LLM Summary Entry Coverage Gap: The Landlord Playbook provided individual LLM Summary Entries per article. The Seller Playbook provided only a single consolidated entry. Due to the volume of content (50 articles), generating individual per-article LLM entries for every seller article would require content-level analysis beyond structural compilation. The consolidated entry is preserved; individual entries should be generated during the editorial review phase.

3. Compliance vs. Knowledge Base Separation: The source compliance document combined developer implementation specifications with substantive compliance content. These have been separated: compliance content appears in Sections IV and V; developer specifications are excluded from the Knowledge Base Master Document.

4. Fair Housing Overlap: Fair housing content appeared in both the Compliance Package (Section 5.4 of source) and as a standalone requirement. This has been resolved by placing the summary commitment in Section IV (Compliance Package, item 5) with full documentation in Section V (Fair Housing Documentation), with cross-reference.

---

End of Botway Knowledge Base Master Document Compiled: 2026-03-01 Format: Markdown (machine-readable) Status: Ready for developer handoff and publication pipeline