{
  "schema_version": 1,
  "extracted_at": "2026-11-13",
  "language": "java",
  "hash_algorithm": "SHA-256 on exact original bytes",
  "scope": "Complete javaguide.md snapshot with selected Chinese review notes; not all languages in google/styleguide",
  "sources": [
    {
      "repo": "google/styleguide",
      "branch": "gh-pages",
      "commit": "52f2e7406a802778e44b92694d4aead252b09091",
      "extracted_at": "2026-11-13",
      "license": "CC-BY-3.0 (prose); Apache-2.0 (code samples)",
      "license_evidence": "https://github.com/google/styleguide/blob/52f2e7406a802778e44b92694d4aead252b09091/README.md#licensing",
      "files": [
        {
          "path": "javaguide.md",
          "url": "https://github.com/google/styleguide/blob/52f2e7406a802778e44b92694d4aead252b09091/javaguide.md",
          "git_blob_sha1": "0f48e60891b0499f556d38458435779dc70afbde",
          "sha256": "084327a3084f95e30a653326f0c91d2c289d61f8d7d6be8d056d602a9b6fab3e",
          "bytes": 49104,
          "local_snapshot": "upstream/google-styleguide-original.md",
          "modified": false
        },
        {
          "path": "README.md",
          "url": "https://github.com/google/styleguide/blob/52f2e7406a802778e44b92694d4aead252b09091/README.md",
          "git_blob_sha1": "c39b63b42d0f77f0f2754b87bcbfd7bf77a51e66",
          "sha256": "c87a6ed5b41b1d3a5e33f4e1bf94ddbeca32e04666b495e98d880bfd97b2bb87",
          "bytes": 4934,
          "local_snapshot": "upstream/google-styleguide-README-original.md",
          "modified": false
        },
        {
          "path": "LICENSE",
          "url": "https://github.com/google/styleguide/blob/52f2e7406a802778e44b92694d4aead252b09091/LICENSE",
          "git_blob_sha1": "1a16e05564d2aaa880bbe9e506a0a0226d8742cc",
          "sha256": "e6bc9e9c474700b708f568bac9e5a8a9bcb2b1dad53442f5ba449fcb848b8e76",
          "bytes": 19467,
          "local_snapshot": "licenses/google-styleguide-CC-BY-3.0.txt",
          "modified": false
        }
      ]
    }
  ],
  "web_references": [
    {
      "url": "https://www.apache.org/licenses/LICENSE-2.0.txt",
      "retrieved_at": "2026-11-13",
      "sha256": "cfc7749b96f63bd31c3c42b5c471bf756814053e847c10f3eb003417bc523d30",
      "bytes": 11358,
      "local_snapshot": "licenses/Apache-2.0.txt",
      "purpose": "Complete license text for upstream code samples"
    }
  ],
  "derived_files": [
    {
      "path": "google-styleguide.md",
      "source": "javaguide.md",
      "description": "Chinese summary by upstream section with selected exceptions and explicitly separated local review guidance; not a complete translation",
      "prose_license": "CC-BY-3.0"
    }
  ],
  "upstream_numbered_section_count": 94,
  "upstream_sections": [
    {
      "number": "1",
      "title": "Introduction"
    },
    {
      "number": "1.1",
      "title": "Terminology notes"
    },
    {
      "number": "1.2",
      "title": "Guide notes"
    },
    {
      "number": "2",
      "title": "Source file basics"
    },
    {
      "number": "2.1",
      "title": "File name"
    },
    {
      "number": "2.2",
      "title": "File encoding: UTF-8"
    },
    {
      "number": "2.3",
      "title": "Special characters"
    },
    {
      "number": "2.3.1",
      "title": "Whitespace characters"
    },
    {
      "number": "2.3.2",
      "title": "Special escape sequences"
    },
    {
      "number": "2.3.3",
      "title": "Non-ASCII characters"
    },
    {
      "number": "3",
      "title": "Source file structure"
    },
    {
      "number": "3.1",
      "title": "License or copyright information, if present"
    },
    {
      "number": "3.2",
      "title": "Package declaration"
    },
    {
      "number": "3.3",
      "title": "Imports"
    },
    {
      "number": "3.3.1",
      "title": "No wildcard imports"
    },
    {
      "number": "3.3.1.1",
      "title": "No module imports"
    },
    {
      "number": "3.3.2",
      "title": "No line-wrapping"
    },
    {
      "number": "3.3.3",
      "title": "Ordering and spacing"
    },
    {
      "number": "3.3.4",
      "title": "No static import for classes"
    },
    {
      "number": "3.4",
      "title": "Class declaration"
    },
    {
      "number": "3.4.1",
      "title": "Exactly one top-level class declaration"
    },
    {
      "number": "3.4.2",
      "title": "Ordering of class contents"
    },
    {
      "number": "3.4.2.1",
      "title": "Overloads: never split"
    },
    {
      "number": "3.5",
      "title": "Module declaration"
    },
    {
      "number": "3.5.1",
      "title": "Ordering and spacing of module directives"
    },
    {
      "number": "4",
      "title": "Formatting"
    },
    {
      "number": "4.1",
      "title": "Braces"
    },
    {
      "number": "4.1.1",
      "title": "Use of optional braces"
    },
    {
      "number": "4.1.2",
      "title": "Nonempty blocks: K & R style"
    },
    {
      "number": "4.1.3",
      "title": "Empty blocks: may be concise"
    },
    {
      "number": "4.2",
      "title": "Block indentation: +2 spaces"
    },
    {
      "number": "4.3",
      "title": "One statement per line"
    },
    {
      "number": "4.4",
      "title": "Column limit: 100"
    },
    {
      "number": "4.5",
      "title": "Line-wrapping"
    },
    {
      "number": "4.5.1",
      "title": "Where to break"
    },
    {
      "number": "4.5.2",
      "title": "Indent continuation lines at least +4 spaces"
    },
    {
      "number": "4.6",
      "title": "Whitespace"
    },
    {
      "number": "4.6.1",
      "title": "Vertical whitespace (blank lines)"
    },
    {
      "number": "4.6.2",
      "title": "Horizontal whitespace"
    },
    {
      "number": "4.6.3",
      "title": "Horizontal alignment: never required"
    },
    {
      "number": "4.7",
      "title": "Grouping parentheses: recommended"
    },
    {
      "number": "4.8",
      "title": "Specific constructs"
    },
    {
      "number": "4.8.1",
      "title": "Enum classes"
    },
    {
      "number": "4.8.2",
      "title": "Variable declarations"
    },
    {
      "number": "4.8.2.1",
      "title": "One variable per declaration"
    },
    {
      "number": "4.8.2.2",
      "title": "Declared when needed"
    },
    {
      "number": "4.8.3",
      "title": "Arrays"
    },
    {
      "number": "4.8.3.1",
      "title": "Array initializers: can be \"block-like\""
    },
    {
      "number": "4.8.3.2",
      "title": "No C-style array declarations"
    },
    {
      "number": "4.8.4",
      "title": "Switch statements and expressions"
    },
    {
      "number": "4.8.4.1",
      "title": "Indentation"
    },
    {
      "number": "4.8.4.2",
      "title": "Fall-through: commented"
    },
    {
      "number": "4.8.4.3",
      "title": "Exhaustiveness and presence of the `default` label"
    },
    {
      "number": "4.8.4.4",
      "title": "Switch expressions"
    },
    {
      "number": "4.8.5",
      "title": "Annotations"
    },
    {
      "number": "4.8.5.1",
      "title": "Type-use annotations"
    },
    {
      "number": "4.8.5.2",
      "title": "Class, package, and module annotations"
    },
    {
      "number": "4.8.5.3",
      "title": "Method and constructor annotations"
    },
    {
      "number": "4.8.5.4",
      "title": "Field annotations"
    },
    {
      "number": "4.8.5.5",
      "title": "Parameter and local variable annotations"
    },
    {
      "number": "4.8.6",
      "title": "Comments"
    },
    {
      "number": "4.8.6.1",
      "title": "Block comment style"
    },
    {
      "number": "4.8.6.2",
      "title": "TODO comments"
    },
    {
      "number": "4.8.7",
      "title": "Modifiers"
    },
    {
      "number": "4.8.8",
      "title": "Numeric Literals"
    },
    {
      "number": "4.8.9",
      "title": "Text Blocks"
    },
    {
      "number": "5",
      "title": "Naming"
    },
    {
      "number": "5.1",
      "title": "Rules common to all identifiers"
    },
    {
      "number": "5.2",
      "title": "Rules by identifier type"
    },
    {
      "number": "5.2.1",
      "title": "Package and module names"
    },
    {
      "number": "5.2.2",
      "title": "Class names"
    },
    {
      "number": "5.2.3",
      "title": "Method names"
    },
    {
      "number": "5.2.4",
      "title": "Constant names"
    },
    {
      "number": "5.2.5",
      "title": "Non-constant field names"
    },
    {
      "number": "5.2.6",
      "title": "Parameter names"
    },
    {
      "number": "5.2.7",
      "title": "Local variable names"
    },
    {
      "number": "5.2.8",
      "title": "Type variable names"
    },
    {
      "number": "5.2.9",
      "title": "Unnamed variables"
    },
    {
      "number": "5.3",
      "title": "Camel case: defined"
    },
    {
      "number": "6",
      "title": "Programming Practices"
    },
    {
      "number": "6.1",
      "title": "`@Override`: always used"
    },
    {
      "number": "6.2",
      "title": "Caught exceptions: not ignored"
    },
    {
      "number": "6.3",
      "title": "Static members: qualified using class"
    },
    {
      "number": "6.4",
      "title": "Finalizers: not used"
    },
    {
      "number": "7",
      "title": "Javadoc"
    },
    {
      "number": "7.1",
      "title": "Formatting"
    },
    {
      "number": "7.1.1",
      "title": "General form"
    },
    {
      "number": "7.1.2",
      "title": "Paragraphs"
    },
    {
      "number": "7.1.3",
      "title": "Block tags"
    },
    {
      "number": "7.2",
      "title": "The summary fragment"
    },
    {
      "number": "7.3",
      "title": "Where Javadoc is used"
    },
    {
      "number": "7.3.1",
      "title": "Exception: self-explanatory members"
    },
    {
      "number": "7.3.2",
      "title": "Exception: overrides"
    },
    {
      "number": "7.3.4",
      "title": "Non-required Javadoc"
    }
  ]
}
