You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: .github/copilot-instructions.md
+12-14Lines changed: 12 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -33,25 +33,23 @@ The library is structured around three core concepts:
33
33
34
34
### Maven Build Commands
35
35
36
-
⚠️ **CRITICAL DEPENDENCY ISSUE**: The build currently fails due to network connectivity issues with the jogamp repository (jogamp.org). This is a known external issue.
When jogamp repository is unavailable, the build will fail. This is a known issue and not related to code changes. The library uses JOGL for OpenGL graphics rendering.
52
+
**Note**: The library uses JOGL for OpenGL graphics rendering, which requires access to the jogamp.org repository. This dependency is now working correctly in the CI environment.
55
53
56
54
### Documentation Build
57
55
@@ -140,7 +138,7 @@ src/
140
138
### Validation Steps
141
139
1.**Documentation Coverage**: Run `./s4j` to ensure all public APIs are documented
142
140
2.**Example Compilation**: All reference examples should compile successfully
143
-
3.**Maven Build**: Should pass when jogamp repository is accessible
141
+
3.**Maven Build**: Standard build commands work with all profiles
144
142
4.**Documentation Build**: `npx hyperbook build` should complete successfully
145
143
146
144
## Templates and Starter Projects
@@ -215,9 +213,9 @@ The repository includes VS Code configuration with:
215
213
## Troubleshooting Common Issues
216
214
217
215
### Build Failures
218
-
1.**jogamp.org dependency errors**: External repository issue, not code-related
216
+
1.**Maven cache issues**: Run `mvn clean` and retry
219
217
2.**Java version mismatch**: Ensure Java 17+ is installed and active
220
-
3.**Maven cache issues**: Run `mvn clean` and retry
218
+
3.**Dependency download issues**: Check network connectivity and retry
221
219
222
220
### Documentation Issues
223
221
1.**Missing documentation warnings**: Run `./s4j --create` to generate templates
@@ -228,7 +226,7 @@ Examples in `src/examples/java/` should compile with the main source. They're in
228
226
229
227
## Working with This Repository
230
228
231
-
**ALWAYS** trust these instructions and refer to them before exploring. The build system has known external dependencies that may fail intermittently. Focus on:
229
+
**ALWAYS** trust these instructions and refer to them before exploring. Focus on:
232
230
233
231
1. Understanding the core Sprite/Stage/Window architecture
234
232
2. Using the reference examples in `src/examples/java/reference/` as patterns
@@ -237,6 +235,6 @@ Examples in `src/examples/java/` should compile with the main source. They're in
237
235
238
236
When making changes, ensure:
239
237
- All public APIs have corresponding documentation
240
-
- Examples compile successfully (when dependencies are available)
238
+
- Examples compile successfully
241
239
- Changes follow the established patterns in existing code
242
240
- Documentation is updated in both English and German if adding new features
0 commit comments