Skip to content

Conversation

@earlduque
Copy link
Contributor

This PR implements a major repository reorganization to align with the
updated contribution guidelines and improve the overall structure of the
ServiceNow Developer Program's Code Snippets Repository.

Key Changes

  • 🗂️ Repository Structure Overhaul: Reorganized all 900+ code snippets into
    the standardized 6 top-level categories as defined in the updated
    contribution guidelines
  • 📋 Enhanced Documentation: Added comprehensive AGENTS.md file with
    detailed repository guidelines, development standards, and contribution
    requirements
  • 🔧 Configuration Updates: Updated Agent settings and GitHub workflow
    configurations
  • 📁 Category Standardization: Moved all existing snippets from previous
    directory structure to the new mandatory category structure:
    • Core ServiceNow APIs/ (GlideRecord, GlideAjax, GlideDateTime, etc.)
    • Server-Side Components/ (Business Rules, Script Includes, Background
      Scripts, etc.)
    • Client-Side Components/ (Client Scripts, UI Actions, Catalog Client
      Scripts, etc.)
    • Modern Development/ (Service Portal, NOW Experience, GraphQL, etc.)
    • Integration/ (REST APIs, Import Sets, Mail Scripts, etc.)
    • Specialized Areas/ (CMDB, ITOM, Performance Analytics, etc.)

Technical Improvements

  • 📝 Documentation Standardization: All code snippets now follow consistent
    README.md documentation patterns
  • 🔍 Improved Discoverability: Better categorization makes finding relevant
    code examples more intuitive
  • ⚡ Enhanced Maintainability: Clearer structure reduces contribution
    friction and improves code review process
  • 🛡️ Quality Enforcement: Updated guidelines ensure higher code quality and
    consistency across all contributions

Breaking Changes

  • Directory Structure: All file paths have changed due to reorganization
  • Navigation: Links and bookmarks to specific snippets will need to be
    updated
  • Contribution Process: New submissions must follow the mandatory 6-category
    structure

This refactoring establishes a solid foundation for the repository's
continued growth while maintaining the high-quality, practical ServiceNow
development examples that make this resource valuable to the community.

@earlduque earlduque merged commit 69db86a into main Sep 22, 2025
1 check passed
@ravichandra1998g ravichandra1998g mentioned this pull request Oct 7, 2025
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