GeoMajas Provenance Review

Guidelines

= Library/Component Review =

External dependencies
See spreadsheet.

= Code Copyright Review = History :
 * The original code was developed by DFC nv
 * The IP was bought by Geosparc nv from DFC nv on 01 Jan 2009
 * Any changes since code is owned by Geosparc nv should by covered by a CLA (Contributer's License Agreement), transferring copyright to Geosparc nv

General, see contributors guide :
 * All Java files contain a copyright statement which is checked as part of the build.
 * All authors should add there name in the list of authors at the top of the files.

The objective here is to visit every source file, and identify possible issues, and work to "regularize" things.

See spreadsheet.

= Review Document =

The result of the provenance review is two fold. First, there is clarification and "fixes" done during the review. For instance, adding missing copyright notices, or factoring out external libraries. The second is a review report with a fairly detailed list of outstanding issues, ambiguities and information of note.

See spreadsheet.

The review document will be distributed to the project PSC members, as well as the incubation committee. Based on it, the incubation committee may require the project to do additional work, either resolving ambiguities, factoring items out, or rewriting questional components.

When completed, a much briefer form of the review document should be prepared, just listing information that would be pertinent to folks using the project. Essentially a summary. This summary might live in source control as README.LICENSE or something similar.

Copyright Header
It is sufficient to refer to a single copy of the license agreement for the project, but each file should include an indication of what the license is, and the location of the full license document.

The header which needs to be included in all Java files (JavaScript and XML files have the same text but using different formatting/comment style):

/* * This file is part of Geomajas, a component framework for building * rich Internet applications (RIA) with sophisticated capabilities for the * display, analysis and management of geographic information. * It is a building block that allows developers to add maps * and other geographic data capabilities to their web applications. * * Copyright 2008-2010 Geosparc, http://www.geosparc.com, Belgium * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU Affero General Public License as * published by the Free Software Foundation, either version 3 of the * License, or (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU Affero General Public License for more details. * * You should have received a copy of the GNU Affero General Public License * along with this program. If not, see . */