diff --git a/.editorconfig b/.editorconfig new file mode 100644 index 000000000..3c026ec9c --- /dev/null +++ b/.editorconfig @@ -0,0 +1,12 @@ +root = true + +[*] +indent_style = space +indent_size = 4 +end_of_line = lf +charset = utf-8 +trim_trailing_whitespace = true +insert_final_newline = true + +[*.{yml,yaml,json,md,js,css}] +indent_size = 2 diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml new file mode 100644 index 000000000..60fabe4f9 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/bug_report.yml @@ -0,0 +1,28 @@ +name: "🐛 Bug Report / 问题与错误反馈" +description: "Report a bug or layout error in the Java guide website or textbook scripts" +title: "[Bug]: " +labels: ["bug"] +body: + - type: markdown + attributes: + value: | + Please fill out this form to report a bug. / 请填写此表单报告排版或代码执行错误。 + - type: textarea + id: description + attributes: + label: "Bug Description / 问题描述" + description: "A clear description of what the issue is." + placeholder: "e.g., Code block fails on chapter X due to Spring Boot version update..." + validations: + required: true + - type: textarea + id: reproduction + attributes: + label: "Reproduction Steps / 复现步骤" + description: "How can we reproduce the error?" + placeholder: | + 1. Open chapter... + 2. Run code block... + 3. See error... + validations: + required: true diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml new file mode 100644 index 000000000..75efd6c92 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/feature_request.yml @@ -0,0 +1,17 @@ +name: "🚀 Suggestion / 功能或内容建议" +description: "Suggest a new topic, section, or website enhancement" +title: "[Suggestion]: " +labels: ["enhancement"] +body: + - type: markdown + attributes: + value: | + Suggest recommendations for the Java progression guide. / 欢迎为本 Java 进阶之路指南提出改进建议。 + - type: textarea + id: details + attributes: + label: "Details / 建议详情" + description: "What Java features, frameworks, or site pages should be added?" + placeholder: "Suggest adding microservice deployment section..." + validations: + required: true diff --git a/CODE_OF_CONDUCT.md b/CODE_OF_CONDUCT.md new file mode 100644 index 000000000..33739459c --- /dev/null +++ b/CODE_OF_CONDUCT.md @@ -0,0 +1,55 @@ +# Contributor Covenant Code of Conduct + +## Our Pledge + +We as members, contributors, and leaders pledge to make participation in our +community a harassment-free experience for everyone, regardless of age, body +size, visible or invisible disability, ethnicity, sex characteristics, gender +identity and expression, level of experience, education, socio-economic status, +nationality, personal appearance, race, caste, color, religion, or sexual +identity and orientation. + +We pledge to act and interact in ways that contribute to an open, welcoming, +diverse, inclusive, and healthy community. + +## Our Standards + +Examples of behavior that contributes to a positive environment for our +community include: + +* Demonstrating empathy and kindness toward other people +* Being respectful of differing opinions, viewpoints, and experiences +* Giving and gracefully accepting constructive feedback +* Accepting responsibility and apologizing to those affected by our mistakes, + and learning from the experience +* Focusing on what is best for the overall community, not just for us as + individuals + +Examples of unacceptable behavior include: + +* The use of sexualized language or imagery, and unwelcome sexual attention or + advances +* Trolling, insulting or derogatory comments, and personal or political attacks +* Public or private harassment +* Publishing others' private information, such as a physical or email + address, without their explicit permission +* Other conduct which could reasonably be considered inappropriate in a + professional setting + +## Enforcement Responsibilities + +Community leaders are responsible for clarifying and enforcing our standards of +acceptable behavior and will take appropriate and fair corrective action in +response to any behavior that they deem inappropriate, threatening, offensive, +or harmful. + +## Scope + +This Code of Conduct applies within all community spaces, and also applies when +an individual is officially representing the community in public spaces. + +## Reporting & Contact + +Instances of abusive, harassing, or otherwise unacceptable behavior may be +reported to the repository owners. All complaints will be reviewed and investigated +promptly and fairly. diff --git a/SECURITY.md b/SECURITY.md new file mode 100644 index 000000000..49ef9f815 --- /dev/null +++ b/SECURITY.md @@ -0,0 +1,13 @@ +# Security Policy / 安全策略 + +## Supported Versions / 支持的版本 + +Only the latest stable release build on the `master` branch is supported with security updates. + +## Reporting a Vulnerability / 漏洞汇报 + +If you identify a security vulnerability in our build scripts, parser pipelines, or code examples, please do **not** open a public issue. + +Please report vulnerabilities privately by emailing the repository owner or using GitHub's private vulnerability reporting feature. + +如果您在我们的构建脚本、解析管道或示例代码中发现安全漏洞,请勿通过公开 Issue 报告,请使用 GitHub 的私有漏洞报告功能或直接发送电子邮件联系维护者。