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
* Updated readme and community health files for upcoming release
* Improved readme formatting. Added 'mailto:' to email links.
Co-authored-by: Mark Peterson <markpet@yahoo.com>
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+7-8Lines changed: 7 additions & 8 deletions
Original file line number
Diff line number
Diff line change
@@ -18,7 +18,7 @@
18
18
**Please do not file an issue to ask a question.** You will get faster results by using the following resources:
19
19
20
20
- Check out the [WorldWind Forum](https://forum.worldwindcentral.com/)
21
-
- Email the [Administrative Contact](mailto:patrick.hogan@nasa.gov)
21
+
- Email the [Administrative Contact](mailto:arc-worldwind@mail.nasa.gov)
22
22
23
23
## Design and Coding Guidelines
24
24
@@ -27,7 +27,7 @@ WorldWind projects.
27
27
28
28
### General
29
29
30
-
* The project's development IDE is WebStorm. The WebStorm configuration files for the project are checked in to the code repository. They define within them dependencies and formatting rules.
30
+
* The project's development IDE is Visual Studio Code. The VS Code configuration files for the project are checked in to the code repository. They define within them dependencies and formatting rules.
31
31
* The Module pattern is followed for all functionality. All JavaScript code is captured within a module. There is only one global defined by Web WorldWind, and that is the `WorldWind` singleton. It contains the constructors and static functions used throughout the rest of the library.
32
32
* RequireJS is used to support the Module pattern and to provide AMD. Every module participates in RequireJS/AMD.
33
33
* Web WorldWind never crashes the browser. Always catch exceptions at least at the highest entry point, e.g., event listeners and thread execution.
@@ -38,7 +38,6 @@ WorldWind projects.
38
38
* A rendering unit assumes that the WebGL state is entirely at its default value when the rendering unit is given control. The full WebGL state must be restored before the rendering unit releases control.
39
39
* Web WorldWind is designed such that the right things just happen once things are set up. The effect of something going wrong is benign. Avoiding micromanagement of state and code brittleness. For example, layers fork off retrieval of data but they don't try to keep track of these retrievals. If the retrieval succeeds then the data will be available the next time the layer looks for it. If it's not available at that point then the layer will simply ask for it again.
40
40
* All code uses the JavaScript "use strict" directive.
41
-
* WebStorm flags code errors and warnings as you write it. The errors are indicated by red and yellow markers in the right margin of a module's editor window. When a module is checked in there should be no red flags and all yellow flags should be addressed to the extent possible. Use F2 in WebStorm to move among errors and warnings. Strive to have no warnings or spelling errors. In this case, the square at the top of the right margin will be dark green. (Light green indicates that there are spelling errors.)
42
41
* The system is designed such that memory allocation and usage is minimized by both the system and its applications. To that end many methods that compute and return a value of type other than Number accept a "result" argument in which to return the computed value. When that argument exists, validate that it is non-null and defined. The result argument is typically used as the return value of the function.
43
42
44
43
### Exceptions
@@ -56,23 +55,23 @@ WorldWind projects.
56
55
* All Web WorldWind code follows the same style and conventions and looks the same in style and format.
57
56
* Web WorldWind code is heavily commented. The comments describe both the what and how of a block of code.
58
57
* Web WorldWind variable and function names are descriptive.
59
-
* Web WorldWind follows the coding conventions described in Chapter 2 of the book *JavaScript Patterns*. These conventions are encoded in the WebStorm project files.
58
+
* Web WorldWind follows the coding conventions described in Chapter 2 of the book *JavaScript Patterns*.
60
59
* Line length is 120 characters and indentation widths are 4 characters.
61
60
* Variable and function names use camel case. The exception is constructors, which capitalize their first letter. Constants are in all upper case with words separated by underscores.
62
61
* White space is preferred over packing code into a small space. Use white space liberally. Separate functional blocks of code with vertical white space. Think of code within a function as a sequence of paragraphs and separate each with a blank line.
63
-
*Set up WebStorm to insert the standard copyright message into new code files.
62
+
*Standard copyright message should be included into new code files.
64
63
65
64
### Documentation
66
65
67
66
* Documentation is generated by JSDoc.
68
-
* Run JSDoc and review the results prior to checking in any code. It's a convenient check on documentation and typing. Set up Grunt (see [HowToBuildWebWW.md](HowToBuildWebWW.md) in the source repository) and use the jsdoc target.
67
+
* Run JSDoc and review the results prior to checking in any code. It's a convenient check on documentation and typing.
69
68
* Document all functions and properties. Mark those meant for internal use only as such.
70
69
* Code isn't complete until the documentation is written. Write all documentation when you implement the function or property. Don't wait until "later". Assume that you will never return to a module to "clean up".
71
70
* Use present tense in all documentation. Examples are: "Indicates that ...", "Computes ...", "Returns ...". Do not use terms like "Will compute" or "Will return".
72
71
* Ensure that the type of all documented arguments and properties is specified in the documentation. For arrays, use {Number[]} and {Vec3[]} and not simply {Array}.
73
72
* Use correct capitalization and full sentences to document everything. All function, parameter and error descriptions start with an upper-case letter and end with a period.
74
73
* Ensure that all method arguments, return values and exceptions are documented.
75
-
* Use WebStorm to identify spelling mistakes in documentation. It will flag them with a wavy underline. Use F2 to move among them.
74
+
* Use the IDE to identify spelling mistakes in documentation. It will flag them with a wavy underline.
76
75
* Class documentation goes in the @classdesc descriptor for the class' constructor.
77
76
78
77
### Commits and Branching
@@ -160,5 +159,5 @@ For Web WorldWind tutorials and examples, please check out our website: https://
160
159
161
160
For community support and FAQs, check out the WorldWind Forum: https://forum.worldwindcentral.com/.
162
161
163
-
To reach our Administrative Contact, please email: [patrick.hogan@nasa.gov](mailto:patrick.hogan@nasa.gov).
162
+
To reach our Administrative Contact, please email: [arc-worldwind@mail.nasa.gov](mailto:arc-worldwind@mail.nasa.gov).
Web WorldWind 0.10.0 and WorldWind Java 2.2.0 are now available on GitHub. The new version of Web WorldWind addresses potential vulnerabilities in the code and underlying packages. The new version of WorldWind Java focuses on upgrading to Java 11 and JOGL 2.4 as well as a switch to Apache 2.0 license. WorldWind's API remains largely unchanged in this release and we are committed to maintaining a consistent API in future releases.
8
-
More information on the release can be found at these links: [Web WorldWind 0.10.0](https://github.com/NASAWorldWind/WebWorldWind/releases) and [WorldWind Java 2.2.0](https://github.com/NASAWorldWind/WorldWindJava/releases).
9
-
Please direct questions to our new email address:
5
+
Web WorldWind 0.11.0 is now available on GitHub. The summary of changes is as follows:
6
+
7
+
- Improvements to COLLADA 3D model support.
8
+
- Added ability to obtain locations of a click in a 3D model.
9
+
- Added visualization support to COLLADA models with wrongly formatted normals.
10
+
- Transparent placemark picking has been fixed.
11
+
- Improvements to Well-Known Text format support.
12
+
- Various fixes to example code files.
13
+
14
+
Development environment changes:
15
+
- Added Chrome and Firefox headless browsers and removed PhantomJS.
16
+
- Switched IDEs from WebStorm to Visual Studio Code.
17
+
- Updated development dependencies to latest versions.
10
18
11
-
arc-worldwind@mail.nasa.gov
19
+
WorldWind's API remains largely unchanged in this release and we are committed to maintaining a consistent API in future releases.
For additional information, please refer to the [releases list](https://github.com/NASAWorldWind/WebWorldWind/releases). Please direct any questions to our email address: [arc-worldwind@mail.nasa.gov](mailto:arc-worldwind@mail.nasa.gov).
22
+
23
+
***
14
24
15
-
3D virtual globe API in JavaScript for the web, developed by NASA. The European Space Agency has provided valuable
16
-
contributions to this platform since 2015. Web WorldWind provides a geographic context, complete with terrain, and a
25
+
Web WorldWind is a 3D planetary globe engine built in JavaScript for the web, developed by NASA. The European Space Agency has provided valuable
26
+
contributions to this platform since 2015. Web WorldWind provides a geographic context complete with terrain, and a
17
27
collection for shapes for displaying and interacting with geographic or geo-located information in 3D and 2D in any
18
28
modern web browser. High-resolution terrain and imagery is retrieved from remote servers automatically as needed, while
19
-
enabling developers to include their own custom terrainand imagery.
29
+
enabling developers to include their own custom terrain, imagery, 3D shapes, and position markings.
20
30
21
-
[worldwind.arc.nasa.gov](https://worldwind.arc.nasa.gov) has setup instructions, developers guides, API documentation and more.
31
+
The project's website, [worldwind.arc.nasa.gov](https://worldwind.arc.nasa.gov) has setup instructions, developer guides, API documentation and more.
22
32
23
33
## Get Started
24
34
25
35
The Web WorldWind [Developer's Guide](https://worldwind.arc.nasa.gov/web) has a complete description of Web WorldWind's
26
-
functionality. You'll also find there links to many Web WorldWind resources, including a user guide. For novices on WorldWind,
27
-
A [Get Started](https://worldwind.arc.nasa.gov/web/get-started/) tutorial is the place to go. The latest Web WorldWind release
28
-
provides many simple [examples](https://github.com/NASAWorldWind/WebWorldWind/tree/develop/examples) showing how to use all of
29
-
Web WorldWind's functionality.
36
+
functionality. In there, you will find many Web WorldWind resources, including a user guide and documentation for every module file.
37
+
For complete beginners on WorldWind, the [Get Started](https://worldwind.arc.nasa.gov/web/get-started/) tutorial is the place to go.
38
+
39
+
The latest Web WorldWind release provides many simple [examples](https://github.com/NASAWorldWind/WebWorldWind/tree/develop/examples) showing
40
+
how to use most of Web WorldWind's functionality, as well as more involved small [applications](https://github.com/NASAWorldWind/WebWorldWind/tree/develop/apps)
41
+
for reference on how to use Web WorldWind in domain-focused GIS development.
0 commit comments