Skip to content

Add common terms and definitions page to specification #570

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Conversation

Copilot
Copy link

@Copilot Copilot AI commented Jun 23, 2025

This PR adds a new "Definitions" page to the implementors section that consolidates common terms used throughout the Development Container Specification documentation.

Changes Made

  • New page: Added _implementors/definitions.md with comprehensive definitions for key concepts
  • Navigation integration: Page appears in the sidebar navigation with index 10
  • Configuration updates: Updated _config.yml and .gitignore to properly exclude vendor dependencies

Content Included

The definitions page covers essential terms organized into logical sections:

Core Concepts

  • Development Container: Container for application development
  • Environment: Logical instance of development containers
  • Project Workspace Folder: Search location for devcontainer.json files

Configuration

  • devcontainer.json: Main configuration file with location precedence
  • devcontainer-feature.json: Feature metadata files

Features

  • Development Container Features: Self-contained installation units
  • Feature Equality: Rules for determining when features are identical
  • Round Stable Sort: Algorithm for deterministic feature ordering

Orchestration & Lifecycle

  • Image-based/Dockerfile-based/Docker Compose-based: Different container configurations
  • Lifecycle Scripts: Commands that run at specific container stages
  • Customizations: Tool-specific configurations

Metadata

  • Image Metadata: Container image development context
  • Merge Logic: Property combination rules

Testing

✅ Jekyll builds successfully without errors
✅ Page renders correctly with proper formatting
✅ Navigation integration works (appears in sidebar)
✅ All anchor links function properly
✅ Responsive design works on different screen sizes

This provides a centralized reference for developers and implementors to understand key terminology used throughout the specification.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

@bamurtaugh bamurtaugh closed this Jun 23, 2025
@bamurtaugh bamurtaugh deleted the copilot/fix-d971dc2b-42d8-4a51-87fb-b440470b1216 branch June 23, 2025 21:16
@Copilot Copilot AI changed the title [WIP] Add a new page for defining common terms Add common terms and definitions page to specification Jun 23, 2025
@Copilot Copilot AI requested a review from bamurtaugh June 23, 2025 21:25
Copilot finished work on behalf of bamurtaugh June 23, 2025 21:25
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