Skip to content

Conversation

@robch
Copy link
Owner

@robch robch commented Oct 15, 2025

?? This is a draft PR containing development work for expanding the C# coding style documentation.

What's in this PR:

This PR contains development artifacts and work-in-progress content for creating expanded coding style documentation with concrete analogies and educational content.

Development Planning Documents:

  • docs/guide-development/expanded-guide-plan.md - Development roadmap using ASK framework
  • docs/guide-development/sections-ready-for-integration.md - Staging area for completed sections
  • docs/guide-development/integration-summary.md - Development process documentation

Draft Content Sections (with analogies):

  • docs/guide-development/cooking-null-handling-revised.md - Null handling with cooking analogies
  • docs/guide-development/hospital-exception-handling-revised.md - Exception handling with medical analogies
  • docs/guide-development/updated-async-programming-section.md - Async programming with restaurant kitchen analogies

Development Artifacts:

  • docs/guide-development/inventory-section-*.md - Content inventory and analysis
  • docs/guide-development/section-3-*.md - Framework validation work

Process Documentation:

  • todo/code-review-tool-integration-ideas.md - Ideas for integrating code review processes with tooling

Status:

Next Steps:

This PR serves as a workspace for developing enhanced coding style documentation with educational analogies. Content may be extracted and refined for future integration into the main documentation.

robch added 6 commits October 15, 2025 12:29
This commit preserves the current state before cleanup. Content has been
copied to genesis with the following organization:

- docs/guide-development/meta-insights/ -> C:/src/genesis/philosophy/meta-insights/
- docs/guide-development/knowledge-movement-system/ -> C:/src/genesis/philosophy/knowledge-movement-system/
- docs/framework/ -> C:/src/genesis/process/documentation-framework/
- docs/guide-development/*-draft.md -> C:/src/genesis/education/
- todo/top-self-help-books-frameworks.jsonl -> C:/src/genesis/pitch/frameworks/

Remaining content is focused on coding style guidelines and code review processes.
Removed directories and files that were copied to genesis:
- docs/guide-development/meta-insights/ (moved to genesis/philosophy/)
- docs/guide-development/knowledge-movement-system/ (moved to genesis/philosophy/)
- docs/framework/ (moved to genesis/process/documentation-framework/)
- Educational draft files (moved to genesis/education/)
- todo/top-self-help-books-frameworks.jsonl (moved to genesis/pitch/frameworks/)
- todo/self-help-books-2016-to-2023.md (duplicate of genesis/pitch/frameworks/overview.md)

Branch now focuses on:
- Core coding style guidelines (C#-Coding-Style-Essential.md, C#-Coding-Style-Expanded.md)
- Code review processes
- Standard cycod documentation
@robch robch changed the title Robch/2510 oct15 coding style guide documentation [DRAFT] Expanded C# coding style guide development work and process documentation Dec 5, 2025
@robch robch marked this pull request as draft December 5, 2025 00:38
@robch robch closed this Dec 5, 2025
@robch robch deleted the robch/2510-oct15-coding-style-guide-documentation branch December 5, 2025 02:37
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