Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .gitattributes
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# ASI Backbone Learning - Git attributes
# AsiBackbone Learning - Git attributes
#
# Line-ending normalization is defined here rather than left to each
# contributor's local Git configuration. Text files are stored with LF in the
Expand Down
4 changes: 2 additions & 2 deletions .github/DISCUSSION_TEMPLATE/show-and-tell.yml
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@ body:
- type: markdown
attributes:
value: |
Use Show and tell to share projects, experiments, adaptations, diagrams, or implementations inspired by concepts and patterns from ASI Backbone Learning.
Use Show and tell to share projects, experiments, adaptations, diagrams, or implementations inspired by concepts and patterns from AsiBackbone Learning.
Sharing an implementation does not make it a canonical ASI Backbone pattern. Please describe what you changed, learned, and would like feedback on.
Sharing an implementation does not make it a canonical AsiBackbone pattern. Please describe what you changed, learned, and would like feedback on.
- type: textarea
id: project
Expand Down
2 changes: 1 addition & 1 deletion .github/DISCUSSION_TEMPLATE/tutorial-ideas.yml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ body:
- type: markdown
attributes:
value: |
Use Tutorial Ideas to propose new tutorials, labs, examples, learning paths, or educational topics for ASI Backbone Learning.
Use Tutorial Ideas to propose new tutorials, labs, examples, learning paths, or educational topics for AsiBackbone Learning.
A good proposal starts with the learning problem before prescribing a particular product or implementation.
Expand Down
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/01-bug-report.yml
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@ body:
- type: markdown
attributes:
value: |
Thank you for helping improve ASI Backbone Learning.
Thank you for helping improve AsiBackbone Learning.

Use this form for concrete defects in documentation, tutorials, samples,
labs, DocFX output, workflows, links, or repository configuration.
Expand Down
4 changes: 2 additions & 2 deletions .github/ISSUE_TEMPLATE/config.yml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
blank_issues_enabled: true

contact_links:
- name: ASI Backbone Organization Discussions
- name: AsiBackbone Organization Discussions
url: https://github.com/orgs/AsiBackbone/discussions
about: Ask architecture questions, propose learning topics, compare patterns, and discuss broader ideas across the ASI Backbone organization.
about: Ask architecture questions, propose learning topics, compare patterns, and discuss broader ideas across the AsiBackbone organization.
4 changes: 4 additions & 0 deletions .github/workflows/docs-validation.yml
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,7 @@ on:
- 'tools/generate-sitemap.cs'
- 'tools/prepare-indexnow.cs'
- 'tools/publish-x.cs'
- 'tools/validate-asibackbone-6-api-references.cs'
- 'tools/validate-doc-metadata.cs'
- 'tools/validate-docfx-template-baseline.cs'
- '.config/dotnet-tools.json'
Expand Down Expand Up @@ -63,6 +64,9 @@ jobs:
- name: Validate DocFX template baseline
run: dotnet run --file tools/validate-docfx-template-baseline.cs

- name: Validate AsiBackbone 6.0 API references
run: dotnet run --file tools/validate-asibackbone-6-api-references.cs

- name: Restore .NET tools
run: dotnet tool restore

Expand Down
1 change: 0 additions & 1 deletion .github/workflows/link-validation.yml
Original file line number Diff line number Diff line change
Expand Up @@ -59,4 +59,3 @@ jobs:
token: ${{ secrets.GITHUB_TOKEN }}
fail: true
jobSummary: true

6 changes: 3 additions & 3 deletions .zenodo.json
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
{
"title": "ASI Backbone Learning",
"version": "0.15.0",
"title": "AsiBackbone Learning",
"version": "1.0.0",
"upload_type": "lesson",
"description": "ASI Backbone Learning is the educational layer of the ASI Backbone organization: an open, community-oriented, DocFX-published collection of tutorials and architectural comparisons covering practical .NET architecture for governed execution, secure applications, AI integration, and policy-driven systems. Material connects conceptual explanations to working implementations in the AsiBackbone and NetCoreApplicationTemplate repositories. Learning is an educational and architectural resource; it is not a compliance certification, legal standard, security guarantee, or AI/AGI/ASI implementation. Documentation and educational material are licensed under CC BY 4.0. Executable sample code added under samples/ is licensed under the MIT License. See LICENSING.md for component-specific licensing terms.",
"description": "AsiBackbone Learning is the educational layer of the AsiBackbone organization: an open, community-oriented, DocFX-published collection of tutorials and architectural comparisons covering practical .NET architecture for governed execution, secure applications, AI integration, and policy-driven systems. Material connects conceptual explanations to working implementations in the AsiBackbone and NetCoreApplicationTemplate repositories. Learning is an educational and architectural resource; it is not a compliance certification, legal standard, security guarantee, or AI/AGI/ASI implementation. Documentation and educational material are licensed under CC BY 4.0. Executable sample code added under samples/ is licensed under the MIT License. See LICENSING.md for component-specific licensing terms.",
"creators": [
{
"name": "Cavell, Christopher D.",
Expand Down
9 changes: 7 additions & 2 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,8 +6,11 @@ Learning releases are archival and citation snapshots of educational material. T

## [Unreleased]

## [1.0.0] - 2026-09-19

### Added

- Learning 1.0 production compatibility, API-boundary, release-readiness, and release-note guidance aligned with AsiBackbone 6.0.
- Optional post-deployment X publication with source-frontmatter selection,
durable receipt/checkpoint state, canonical-URL reconciliation, protected
OAuth credentials, deterministic dry runs, and offline contract validation.
Expand All @@ -16,7 +19,8 @@ Learning releases are archival and citation snapshots of educational material. T

### Changed

- Aligned all sample tests on `Microsoft.Testing.Platform` and `xunit.v3`, matching the shared ASI Backbone repository posture.
- Aligned current terminology, navigation, tutorials, diagrams, and sample guidance with the finalized AsiBackbone 6.0 vocabulary and public API surface.
- Aligned all sample tests on `Microsoft.Testing.Platform` and `xunit.v3`, matching the shared AsiBackbone repository posture.

## [0.15.0] - 2026-09-11

Expand All @@ -39,5 +43,6 @@ Learning releases are archival and citation snapshots of educational material. T

- Obsolete dependency-check suppressions for packages not used by Learning.

[Unreleased]: https://github.com/AsiBackbone/Learning/compare/v0.15.0...HEAD
[Unreleased]: https://github.com/AsiBackbone/Learning/compare/v1.0.0...HEAD
[1.0.0]: https://github.com/AsiBackbone/Learning/compare/v0.15.0...v1.0.0
[0.15.0]: https://github.com/AsiBackbone/Learning/releases/tag/v0.15.0
12 changes: 6 additions & 6 deletions CITATION.cff
Original file line number Diff line number Diff line change
Expand Up @@ -2,10 +2,10 @@ cff-version: 1.2.0
message: >-
If you use this material, please cite it using the metadata
from this file.
title: "ASI Backbone Learning"
title: "AsiBackbone Learning"
type: dataset
abstract: >-
ASI Backbone Learning is the educational layer of the ASI Backbone
AsiBackbone Learning is the educational layer of the AsiBackbone
organization: an open, community-oriented, DocFX-published collection of
tutorials and architectural comparisons covering practical .NET architecture
for governed execution, secure applications, AI integration, and
Expand All @@ -31,7 +31,7 @@ identifiers:
- type: doi
value: "10.5281/zenodo.21938556"
description: >-
Zenodo concept DOI for ASI Backbone Learning. Always resolves to the
Zenodo concept DOI for AsiBackbone Learning. Always resolves to the
most recent archived version. Cite this when referring to the evolving
work as a whole.
repository-code: "https://github.com/AsiBackbone/Learning"
Expand All @@ -51,7 +51,7 @@ keywords:
- lesson
references:
- type: software
title: "ASI Backbone"
title: "AsiBackbone"
authors:
- family-names: Cavell
given-names: "Christopher D."
Expand All @@ -66,5 +66,5 @@ references:
orcid: "https://orcid.org/0009-0002-2113-0245"
doi: "10.5281/zenodo.20373042"
repository-code: "https://github.com/AsiBackbone/NetCoreApplicationTemplate"
version: "0.15.0"
date-released: "2026-09-11"
version: "1.0.0"
date-released: "2026-09-19"
8 changes: 4 additions & 4 deletions CODE_OF_CONDUCT.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## Our Commitment

The ASI Backbone Learning community is intended to be a constructive, technically rigorous, and welcoming place for people to learn, question, experiment, and contribute.
The AsiBackbone Learning community is intended to be a constructive, technically rigorous, and welcoming place for people to learn, question, experiment, and contribute.

We are committed to providing a community environment that is respectful and free from harassment, intimidation, and discrimination for everyone, regardless of experience level, background, identity, disability, appearance, nationality, race, ethnicity, religion, age, sex, gender identity or expression, sexual orientation, or other personal characteristics.

Expand Down Expand Up @@ -46,7 +46,7 @@ A useful standard is:

> Critique the pattern, implementation, evidence, or reasoning — not the person.

Canonical ASI Backbone patterns may be documented alongside alternative approaches when those alternatives are technically grounded and clearly identified.
Canonical AsiBackbone patterns may be documented alongside alternative approaches when those alternatives are technically grounded and clearly identified.

## Scope

Expand All @@ -58,7 +58,7 @@ This Code of Conduct applies to participation in project spaces, including:
- Code reviews
- Documentation contributions
- Repository-hosted community interactions
- Other public spaces where a participant is representing the ASI Backbone Learning project or organization
- Other public spaces where a participant is representing the AsiBackbone Learning project or organization

It also applies when behavior outside the repository has a direct and material effect on the safety or effective participation of project contributors.

Expand Down Expand Up @@ -110,6 +110,6 @@ The goal is to preserve an environment where participants can:

## Attribution

This Code of Conduct is maintained by the ASI Backbone Learning project and may evolve as the community grows.
This Code of Conduct is maintained by the AsiBackbone Learning project and may evolve as the community grows.

Suggestions for improving the Code of Conduct may be proposed through the repository's normal contribution process.
18 changes: 9 additions & 9 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Contributing to ASI Backbone Learning
# Contributing to AsiBackbone Learning

Thank you for your interest in contributing to `AsiBackbone/Learning`.

Expand Down Expand Up @@ -106,7 +106,7 @@ Choose the category that best matches the conversation:
- **Tutorial Ideas** — proposals for tutorials, labs, examples, learning paths, or future educational material.
- **Show and tell** — projects, experiments, adaptations, diagrams, or implementations inspired by Learning concepts and patterns.

Use [**ASI Backbone Organization Discussions**](https://github.com/orgs/AsiBackbone/discussions) when a topic genuinely spans multiple ASI Backbone repositories or concerns the organization as a whole.
Use [**AsiBackbone Organization Discussions**](https://github.com/orgs/AsiBackbone/discussions) when a topic genuinely spans multiple AsiBackbone repositories or concerns the organization as a whole.

A useful flow is:

Expand Down Expand Up @@ -167,7 +167,7 @@ Where useful, distinguish among:

- **Architecture Pattern** — the general idea
- **Minimal Teaching Example** — the simplified demonstration
- **Working Repository Example** — the fuller implementation in another ASI Backbone repository
- **Working Repository Example** — the fuller implementation in another AsiBackbone repository

Do not duplicate large portions of canonical implementation documentation when a direct reference will serve better.

Expand All @@ -188,7 +188,7 @@ Where appropriate, include:

Architectural disagreement can be educational.

Contributions may present approaches that differ from the current ASI Backbone implementation when those approaches are:
Contributions may present approaches that differ from the current AsiBackbone implementation when those approaches are:

- Technically grounded
- Clearly explained
Expand All @@ -206,7 +206,7 @@ When architectural status materially affects how a page should be interpreted, u

Use one of these values:

- **Canonical Pattern** — aligned with the current architecture of one or more ASI Backbone organization repositories.
- **Canonical Pattern** — aligned with the current architecture of one or more AsiBackbone organization repositories.
- **Alternative Pattern** — a viable different approach, or a comparison centered on an approach that intentionally differs from the current canonical organization pattern.
- **Experimental** — exploratory architecture that tests or extends boundaries without claiming an established organization pattern or production-ready design. Experimental pages should state important assumptions, unknowns, and limits explicitly.
- **General learning material** — educational material for which no stronger architectural-status claim is necessary.
Expand Down Expand Up @@ -524,7 +524,7 @@ Do not introduce category directories such as `articles/security/`, `articles/go

### Problem-Oriented Titles and Slugs

Lead with a developer problem rather than repository vocabulary. Use lowercase kebab-case slugs that remain meaningful outside the ASI Backbone organization.
Lead with a developer problem rather than repository vocabulary. Use lowercase kebab-case slugs that remain meaningful outside the AsiBackbone organization.

Prefer:

Expand Down Expand Up @@ -564,7 +564,7 @@ Before publishing a new standalone article, normally confirm that:
- [ ] `feed: true` opts the article into the existing publication feed.
- [ ] The article stands alone without requiring earlier tutorials or Learning-specific background.
- [ ] The opening establishes a concrete technical problem before introducing repository-specific language.
- [ ] The article does not assume that the reader adopts `AsiBackbone` or another ASI Backbone implementation.
- [ ] The article does not assume that the reader adopts `AsiBackbone` or another AsiBackbone implementation.
- [ ] Established concepts are distinguished from repository-specific terminology where appropriate.
- [ ] Deeper tutorials, samples, labs, ADRs, or implementation material are linked rather than reproduced wholesale.
- [ ] Contextual links identify a small number of natural next steps and explain why each destination is relevant; reciprocal links are added only where they improve reader flow.
Expand Down Expand Up @@ -869,7 +869,7 @@ These requests are part of maintaining a useful learning resource.

Do not report security vulnerabilities through a public Issue when disclosure could create risk.

Follow the security reporting guidance provided by the repository or ASI Backbone organization when available.
Follow the security reporting guidance provided by the repository or AsiBackbone organization when available.

Never include:

Expand Down Expand Up @@ -912,7 +912,7 @@ The project may recognize contributors through Git history, release notes, contr

## Questions

If you are unsure whether an idea belongs in the repository, start an [ASI Backbone Organization Discussion](https://github.com/orgs/AsiBackbone/discussions).
If you are unsure whether an idea belongs in the repository, start an [AsiBackbone Organization Discussion](https://github.com/orgs/AsiBackbone/discussions).

If you have identified a concrete problem, open an Issue.

Expand Down
6 changes: 3 additions & 3 deletions GOVERNANCE.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,7 @@ Scoped authority
Host-owned execution
Audit residue
Decision receipt
```

A useful design principle is:
Expand Down Expand Up @@ -183,7 +183,7 @@ Significant decisions include:
- Changes to licensing
- Changes to project scope
- Removal or deprecation of major tutorial areas
- Changes that materially alter how the project relates to other ASI Backbone repositories
- Changes that materially alter how the project relates to other AsiBackbone repositories

These should normally be discussed publicly before implementation.

Expand All @@ -205,7 +205,7 @@ Learning content may be classified to help readers understand its status.

### Canonical Pattern

A pattern aligned with the current documented architecture of one or more ASI Backbone organization repositories.
A pattern aligned with the current documented architecture of one or more AsiBackbone organization repositories.

Canonical does not mean universally correct.

Expand Down
2 changes: 1 addition & 1 deletion LICENSING.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Licensing

ASI Backbone Learning contains educational material and executable
AsiBackbone Learning contains educational material and executable
software examples distributed under different licenses.

## Documentation and Educational Material
Expand Down
Loading
Loading