Canemah Nature Laboratory Technical Note Style Guide
Canemah Nature Laboratory Technical Note Style Guide
Document ID: CNL-SG-2025-001
Version: 1.0
Date: November 29, 2025
Author: Michael P. Hamilton, Ph.D.
1. Overview
This style guide establishes standards for the Canemah Nature Laboratory (CNL) Technical Note series. Technical Notes document research findings, protocol development, system specifications, and experimental results from the Macroscope project and related work.
2. Document Numbering System
2.1 Format
CNL-[TYPE]-[YEAR]-[SEQ]
Components:
- CNL: Canemah Nature Laboratory (fixed prefix)
- TYPE: Document type code (see below)
- YEAR: Four-digit year
- SEQ: Three-digit sequential number, zero-padded (001, 002, etc.)
2.2 Document Type Codes
| Code | Type | Purpose |
|---|---|---|
| TN | Technical Note | Research findings, experimental results, analyses |
| SP | Specification | System specifications, API documentation |
| PR | Protocol | Standard operating procedures, methodologies |
| WP | Working Paper | Preliminary findings, work in progress |
| SG | Style Guide | Documentation standards (this document) |
| DR | Design Review | Architecture decisions, design rationale |
2.3 Examples
CNL-TN-2025-001— First technical note of 2025CNL-SP-2025-003— Third specification of 2025CNL-PR-2026-001— First protocol of 2026
2.4 Sequence Numbers
- Sequence numbers are assigned chronologically within each year
- Numbers do not reset by document type (all types share the same sequence)
- Maintain a registry file (
CNL-REGISTRY.md) to track assigned numbers
3. Document Structure
3.1 Required Sections (Technical Notes)
-
Title Block
- Document title
- Subtitle (if applicable)
- Document ID
- Version number
- Date
- Author(s)
-
AI Assistance Disclosure (when applicable)
- Specific AI tools used
- Nature of AI contribution
- Statement of author responsibility
-
Abstract
- 150-300 words
- Summarize objectives, methods, key findings, implications
- No citations in abstract
-
Introduction
- Context and motivation
- Research questions or objectives
- Scope of the work
-
Methodology
- Sufficient detail for replication
- Hardware and software specifications
- Data sources and sampling procedures
-
Results
- Present findings with appropriate tables/figures
- Include sample sizes and statistical measures
- Number tables and figures sequentially
-
Discussion
- Interpret findings
- Compare with prior work
- Address implications
-
Limitations
- Acknowledge constraints on generalizability
- Note potential biases or confounds
-
Conclusion
- Summarize key findings
- State practical implications
-
References
- Numbered citation format
- Include DOIs or URLs where available
-
Appendices (optional)
- Technical details
- Supplementary data
- Code listings
-
Document History
- Version log with dates and changes
3.2 Section Numbering
- Use decimal numbering: 1, 1.1, 1.2, 2, 2.1, etc.
- Maximum three levels (e.g., 2.3.1)
- Appendices use letters: Appendix A, Appendix B
4. Formatting Standards
4.1 Typography
| Element | Font | Size | Style |
|---|---|---|---|
| Body text | Arial | 12pt | Regular |
| Main title | Arial | 24pt | Bold |
| Subtitle | Arial | 18pt | Bold |
| Heading 1 | Arial | 16pt | Bold |
| Heading 2 | Arial | 13pt | Bold |
| Heading 3 | Arial | 12pt | Bold, Italic |
| Table text | Arial | 11pt | Regular |
| Figure captions | Arial | 11pt | Regular |
| References | Arial | 11pt | Regular |
| Headers/Footers | Arial | 10pt | Italic |
4.2 Page Layout
- Paper size: US Letter (8.5" × 11")
- Margins: 1 inch (all sides)
- Line spacing: 1.15 or single
- Paragraph spacing: 6pt after paragraphs
- Alignment: Left-justified (ragged right) for body text
4.3 Headers and Footers
- Header (right-aligned): Document ID (e.g., CNL-TN-2025-001)
- Footer (centered): Page X of Y
4.4 Tables
- Number sequentially (Table 1, Table 2, etc.)
- Caption above table, bold
- Light gray header row (#E8E8E8)
- Light gray borders (#CCCCCC)
- Center-align numerical data
- Left-align text data
- Include units in column headers
4.5 Figures
- Number sequentially (Figure 1, Figure 2, etc.)
- Caption below figure
- Minimum 150 DPI for images
- Prefer vector formats (SVG) for diagrams
- Include axis labels with units
5. Citation Format
5.1 In-Text Citations
Use numbered references in square brackets:
Previous work has shown logarithmic scaling [1]. Multiple studies confirm this finding [2,3]. As noted by Hamilton et al. [4], the pattern holds across domains.
5.2 Reference List Format
Journal Article:
[1] Author, A. A., Author, B. B., & Author, C. C. (Year). "Title of article." Journal Name, Volume(Issue), pages. DOI
ArXiv Preprint:
[2] Author, A. A., et al. (Year). "Title of paper." arXiv:XXXX.XXXXX.
Book:
[3] Author, A. A. (Year). Title of Book. Publisher.
Website/Software:
[4] Organization (Year). "Title." URL (accessed Date).
5.3 Reference Examples
[1] Gemma Team (2025). "Gemma 3 Technical Report." Google DeepMind. arXiv:2503.19786.
[2] Lin, S., Hilton, J., & Evans, O. (2022). "TruthfulQA: Measuring How Models Mimic Human Falsehoods." Proceedings of ACL 2022.
[3] Ollama (2024). "Ollama: Run Large Language Models Locally." https://ollama.ai (accessed November 29, 2025).
6. AI Assistance Disclosure
6.1 Policy
Following guidelines from ACM, Springer Nature, and Taylor & Francis:
- AI tools (ChatGPT, Claude, etc.) cannot be listed as authors
- AI assistance must be disclosed when used substantively
- Human author(s) take full responsibility for content
6.2 Disclosure Statement Template
Place after author information, in a bordered box:
AI Assistance Disclosure: This [document type] was developed with assistance from [AI tool name and version]. The AI contributed to [specific contributions: e.g., literature review, code development, data analysis, manuscript drafting, editing]. The author(s) take full responsibility for the content, accuracy, and conclusions.
6.3 What Requires Disclosure
Disclose:
- AI-generated text incorporated into the document
- AI assistance with study design or methodology
- AI-generated code used in analysis
- AI assistance with data interpretation
- AI serving as an evaluation tool (e.g., LLM-as-judge)
Does not require disclosure:
- Grammar/spell checking
- Standard word processing features
- Search engines
7. Scientific Notation and Units
7.1 Numbers
- Spell out numbers one through nine in prose
- Use numerals for 10 and above
- Use numerals with units (e.g., "5 km", not "five km")
- Use commas for thousands: 1,000; 10,000; 1,000,000
- Use scientific notation for very large/small: 3.2 × 10⁸
7.2 Units
- Use SI units where possible
- Include units in parentheses after first use: "temperature (°C)"
- Define abbreviations on first use
7.3 Statistical Reporting
- Report exact p-values to three decimal places (p = 0.023)
- For very small values: p < 0.001
- Include sample sizes: (n = 20)
- Report confidence intervals: 95% CI [0.32, 0.48]
- Include effect sizes where appropriate
8. Species and Technical Nomenclature
8.1 Species Names
- Italicize scientific names: Recurvirostra americana
- Full binomial on first use, may abbreviate genus thereafter: R. americana
- Common names lowercase unless proper noun: American avocet, California scrub-jay
8.2 Software and Systems
- Capitalize proper names: Python, MySQL, Ollama
- Use official capitalization: macOS, GitHub, JavaScript
- Include version numbers on first mention: Python 3.12, MySQL 8.4
9. File Naming Conventions
9.1 Document Files
CNL-TN-2025-001_Short_Title.docx
CNL-SP-2025-002_System_Specification.docx
- Use document ID as prefix
- Add descriptive short title after underscore
- Use underscores, not spaces
- Use title case for description
9.2 Supporting Files
CNL-TN-2025-001_Fig1_accuracy_chart.png
CNL-TN-2025-001_Table1_results.csv
CNL-TN-2025-001_code.py
10. Version Control
10.1 Version Numbering
- Major versions: 1.0, 2.0, 3.0 (significant revisions)
- Minor versions: 1.1, 1.2, 1.3 (corrections, additions)
- Drafts: 0.1, 0.2, 0.9 (pre-release)
10.2 Document History Section
Include at end of document:
## Document History
| Version | Date | Changes |
|---------|------|---------|
| 0.1 | 2025-11-28 | Initial draft |
| 0.9 | 2025-11-29 | Pre-release review |
| 1.0 | 2025-11-29 | Initial release |
| 1.1 | 2025-12-05 | Corrected Table 2 values |
11. Review and Approval
11.1 Review Process
- Draft (v0.x): Working document, subject to revision
- Review (v0.9): Complete draft for review
- Release (v1.0): Approved for distribution
- Revision (v1.x+): Post-release corrections
11.2 Quality Checklist
Before release, verify:
- [ ] Document ID assigned and registered
- [ ] All sections present and complete
- [ ] Tables and figures numbered correctly
- [ ] All references cited in text
- [ ] All citations appear in reference list
- [ ] AI assistance disclosed (if applicable)
- [ ] Spell check completed
- [ ] Version number and date correct
- [ ] Header contains document ID
- [ ] Footer contains page numbers
12. Registry
Maintain a separate registry file (CNL-REGISTRY.md) with:
# CNL Document Registry
| ID | Title | Author | Date | Status |
|----|-------|--------|------|--------|
| CNL-TN-2025-001 | LLM Knowledge Cartography | Hamilton | 2025-11-29 | Released |
| CNL-SG-2025-002 | Technical Note Style Guide | Hamilton | 2025-11-29 | Released |
Appendix A: Document Templates
Templates for each document type are available at:
/Macroscope/Documentation/Templates/
Appendix B: Revision History
| Version | Date | Changes |
|---|---|---|
| 1.0 | 2025-11-29 | Initial release |
End of Style Guide
Cite This Document
Permanent URL: https://canemah.org/archive/CNL-SG-2025-002