Falling-Metal-Interactive/Blacksite
2
0
Fork 0
Code Issues 15 Pull Requests Actions Packages Projects Releases Wiki Activity

BS-JD-000 - Adoption policy, license notes, and source attribution #2

New Issue
Closed
opened 2026-06-06 01:45:30 -04:00 by Rbanh · 1 comment
Rbanh commented 2026-06-06 01:45:30 -04:00
Owner
Copy Link

Summary

Document which Jackdaw ideas are being adapted, which code may be referenced, and the license/attribution rules for any direct copying.

Why

Blacksite should borrow design lessons without becoming an untracked fork. Any copied code needs correct attribution and source review.

Implementation notes

  • Create a canonical docs page or ADR for Jackdaw-inspired adoption policy.
  • Add an "Inspired by" note in docs/editor/README.md.
  • If direct code is copied, preserve license notes and record source URL plus upstream commit hash.
  • Prefer clean-room reimplementation for geometry, terrain, and operator APIs.

Acceptance criteria

  • Repo has one canonical policy document.
  • Future tickets distinguish design-inspired, API-inspired, and code-derived work.
  • No copied code lands without source and license notes.
  • PR checklist includes Jackdaw source/license confirmation when relevant.

Docs/tests

Docs only. Update docs/editor/README.md and root README only if visible workflow changes.

## Summary Document which Jackdaw ideas are being adapted, which code may be referenced, and the license/attribution rules for any direct copying. ## Why Blacksite should borrow design lessons without becoming an untracked fork. Any copied code needs correct attribution and source review. ## Implementation notes - Create a canonical docs page or ADR for Jackdaw-inspired adoption policy. - Add an "Inspired by" note in `docs/editor/README.md`. - If direct code is copied, preserve license notes and record source URL plus upstream commit hash. - Prefer clean-room reimplementation for geometry, terrain, and operator APIs. ## Acceptance criteria - [ ] Repo has one canonical policy document. - [ ] Future tickets distinguish design-inspired, API-inspired, and code-derived work. - [ ] No copied code lands without source and license notes. - [ ] PR checklist includes Jackdaw source/license confirmation when relevant. ## Docs/tests Docs only. Update `docs/editor/README.md` and root README only if visible workflow changes.
Rbanh added this to the M0 - Foundation and polish seams milestone 2026-06-06 01:45:30 -04:00
Rbanh added the
roadmap:jackdaw
type:docs
priority:P0
area:governance
 labels 2026-06-06 01:45:30 -04:00
Rbanh commented 2026-06-06 02:15:28 -04:00
Author
Owner
Copy Link

Implemented in local commit 19c4d01 (Start M0 editor workflow polish).

Scope:

  • Added ADR 0020 for Jackdaw-inspired source/attribution policy.
  • Indexed ADR 0020 and the Jackdaw roadmap plan in docs/README.md.
  • Added the Jackdaw policy note to docs/editor/README.md.
  • Added PR checklist items for docs and Jackdaw inspiration/source/license classification.

Validation:

  • cargo fmt --check
  • cargo check --workspace
Implemented in local commit `19c4d01` (`Start M0 editor workflow polish`). Scope: - Added ADR 0020 for Jackdaw-inspired source/attribution policy. - Indexed ADR 0020 and the Jackdaw roadmap plan in `docs/README.md`. - Added the Jackdaw policy note to `docs/editor/README.md`. - Added PR checklist items for docs and Jackdaw inspiration/source/license classification. Validation: - `cargo fmt --check` - `cargo check --workspace`
Rbanh closed this issue 2026-06-06 02:15:30 -04:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels   
area:animation

Skeletal animation import, preview, graph/state authoring, and runtime integration.

  
area:assets

Asset browser, material browser, thumbnails, import, processing, and asset watcher.

  
area:audio

Audio source/listener authoring, buses, spatial preview, and runtime integration.

  
area:brushes

Brush geometry, CSG, face editing, UVs, and brush diagnostics.

  
area:build-release

Build profiles, packaging, content validation, release gates, and distribution diagnostics.

  
area:extensions

Static extension API, extension scaffolds, dylib exploration.

  
area:governance

Policy, attribution, planning, and production process.

  
area:hierarchy

Outliner hierarchy, parenting, grouping, prefab structure, ordering, and selection workflows.

  
area:inspector

Inspector, component metadata, component editing UX.

  
area:navigation

Navigation mesh authoring, baking, diagnostics, and AI path preview.

  
area:operators

Editor operator/action framework, undo, commit/cancel semantics.

  
area:physics

Physics placement, colliders, rigid bodies, diagnostics, and overlays.

  
area:project-ux

Project launcher, profiles, templates, or first-run project workflow.

  
area:quality

Regression packs, tests, performance budgets, profiler, first-hour UX.

  
area:rendering

Static and skinned renderers, material slots, shaders, ray tracing, and render-path integration.

  
area:runtime

BRP, remote inspector, PIE, game preview, runtime integration.

  
area:scene-io

Scene document, save/load, schema, migration, or reference repair.

  
area:terrain

Terrain authoring, terrain sculpting, heightmaps, and terrain materials.

  
area:viewport

Viewport interaction, selection, shortcuts, camera, overlays, and controls.

  
priority:P0

Must-have prerequisite or milestone-critical item.

  
priority:P1

Important production feature after P0 work is stable.

  
priority:P2

Useful follow-up or polish item.

  
priority:P3

Exploratory or later spike.

  
roadmap:jackdaw

Jackdaw-inspired Blacksite editor roadmap item.

  
roadmap:production

Blacksite production-readiness roadmap item beyond the Jackdaw-inspired foundation.

  
type:architecture

Architecture, internal framework, or hard-to-reverse technical decision.

  
type:docs

Documentation, policy, samples, or issue-board structure.

  
type:epic

Tracking epic that groups related milestone work.

  
type:feature

User-visible feature or capability.

No Label
area:animation
area:assets
area:audio
area:brushes
area:build-release
area:extensions
area:governance
area:hierarchy
area:inspector
area:navigation
area:operators
area:physics
area:project-ux
area:quality
area:rendering
area:runtime
area:scene-io
area:terrain
area:viewport
priority:P0
priority:P1
priority:P2
priority:P3
roadmap:jackdaw
roadmap:production
type:architecture
type:docs
type:epic
type:feature
Milestone
Clear milestone
No items
No Milestone
M0 - Foundation and polish seams
Projects
Clear projects
No project
Assignees
Clear assignees
No Assignees
1 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: Falling-Metal-Interactive/Blacksite#2
No description provided.
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?