[Incubator] Steps toward merging/deprecating incubation documents
Cameron Shorter
cameron.shorter at gmail.com
Sat Nov 29 16:49:40 PST 2014
Ok, proposed changes are now in place. Additions in style=red, deletions
in <strike> font.
Hopefully style will by forwarded through the email list, otherwise
follow the links to the wiki page.
http://wiki.osgeo.org/wiki/Project_Graduation_Checklist
Project Graduation Checklist
Open
The project has demonstrated that it has an open, active and healthy
user and developer community:
1. [open.1]Open: projects are expected to function in an open and
public manner and include:
* [open.1a]Open source license(s),
* [open.1b]Open communication channels,
* [open.1c]Open decision making process,
2. [open.2]Active and healthy community:
* [open.2a]The project should have a community of developers and
users who actively collaborate and support each other in a
healthy way.
/Eg. collaboration on project activities such as testing,
release and feature development./
* [open.2b]Long term viability of the project is demonstrated by
showing participation,supportand direction from multiple
developers,power users, and/or sponsors, who come from multiple
organisations.
/Eg. The project is resilient enough to sustain loss of a
developer or supporting organisation, often referred to as
having a highbus factor <http://en.wikipedia.org/wiki/Bus_factor>./
* [open.2c] Decisions are made openly instead of behind closed
doors, which empowers all developers to take ownership of the
project and facilitates spreading of knowledge between current
and future team members.
* [open.2d] Users are supported and encouraged, via an email list
or similar.
Copyright and License
We need to ensure that the project owns or otherwise has obtained the
ability to release the project code by completing the following steps:
1. [copyright.1]All project source code is available under an Open
Source license.
2. [copyright.2]Project documentation is available under an open
license, such as Creative Commons.
3. [copyright.3][copyright.1]The project code, documentation and data
has been adequately vetted to assure it is all properly licensed,
and a copyright notice included, as per aProvenance Review
<http://www.osgeo.org/incubator/process/codereview.html>.
4. [copyright.4]The project maintains a list of all copyright holders
identified in the Provenance Review Document.
5. [copyright.5]All code contributors have agreed to abide by the
project's license policy, and this agreement has been documented and
archived.
Processes
1. [processes.1]The project has code under configuration management.
/Eg, subversion, git./
2. [processes.2]The project uses an issue tracker and keeps the status
of the issue tracker up to date.
3. [processes.3]The project has documentedand followsits management
processes.
/This is typically done within a Developers Guide or Project
Management Plan./
* [processes.2a]The project has a suitable open governance policy
ensuring decisions are made, documented and adhered to in a
public manner.
/This typically means a Project Management Committee has been
established with a process for adding new members. A robust
Project Management Committee will typically draw upon
developers, users and key stakeholders from multiple
organisations as there will be a greater variety of technical
visions and the project is more resilient to a sponsor leaving./
* [processes.2b]The project uses public communication channels for
decision making to maintain transparency.
/E.g. archived email list(s), archived IRC channel(s), public
issue tracker./
Documentation
1. [documentation.1]The project has user documentation:
* [documentation.1a]Including sufficient detail to guide a new
user through performing the core functionality provided by the
application.
2. [documentation.2]The project has developer documentation:
* [documentation.2a]Including checkout and build instructions.
* [documentation.2b]Including commented code, ideally published
for developer use.
/Examples: javadocs for Java applications, or Sphinx
documentation for Python applications./
* [documentation.2c]Providing sufficient detail for an experience
programmer to contribute patches or a new module in accordance
with the project's programming conventions.
3. [documentation.3] The project has deployment documentation:
* [documentation.3a] Including, where appropriate, how to deploy,
configure and optimise the application.
Release Procedure
In order to maintain a consistent level of quality, the project should
follow defined release and testing processes.
1. [release.1]The project follows a defined release process:
* [release.1a] Which supports both stable and development releases.
* [release.1b]Which includes execution of the testing process
before releasing a stable release.
2. [release.2]The project follows a documented testing process.
* [release.2a]/Ideally, this includes both automated and manual
testing./
* [release.2b]/Ideally this includes documented conformance to set
quality goals, such as reporting Percentage Code Coverage of
Unit Tests./
3. [release.3]Release and testing processes provide sufficient detail
for an experienced programmer to follow.
4. [release.4] The project has released stable, feature complete releases.
* /Ideally this is demonstrated by describing risk adverse
organisations who have deployed releases into production systems./
OSGeo Committees and Community
The OSGeo Foundation is made up of a number of committees, projects and
local chapters. This section gathers up information these groups have
requested from OSGeo projects. These expectations are not mandatory
requirements before graduation, but a project should be prepared to
address them in order to be considered a good OSGeo citizen.
Board
The OSGeoBoard <http://wiki.osgeo.org/wiki/Board>holds ultimate
responsibility for all OSGeo activities. The Board requests:
1. [board.1]A project provide a Project Officer as a contract point:
* The Project Officer should be listed at:Project Officer
<http://wiki.osgeo.org/wiki/Contacts#Software_Projects>
* This person is established when the incubation committee
recommends the project for graduation
* Your community can change the project officer as needed (just
add an agenda item to the next board meeting so they can
recognise the change of officer).
Marketing
Access to OSGeo'sMarketing_Committee
<http://wiki.osgeo.org/wiki/Marketing_Committee>and
associatedMarketing_Pipeline
<http://wiki.osgeo.org/wiki/Marketing_Pipeline>is one of the key
benefits of joining the OSGeo foundation. The Marketing Committee requests:
1. [marketing.1]Marketing artefacts have been created about the project
in line with the incubation criteria listed in the OSGeo Marketing
Committee'sMarketing Artefacts
<http://wiki.osgeo.org/wiki/Marketing_Artefacts>. This lists the
documentation requirements forOSGeo-Live <http://live.osgeo.org/>.
Marketing Artefacts include:
* [marketing.1a]Application Overview
* [marketing.1b]Application Quick Start
* [marketing.1c]Logo
* [marketing.1d]Graphical Image
2. [marketing.2]Ideally, stable version(s) of executable applications
are bundled with appropriate distributions.
/In most cases, this will at least includeOSGeo-Live
<http://live.osgeo.org/>, but may also includeDebianGIS
<http://wiki.debian.org/DebianGis>,UbuntuGIS
<https://wiki.ubuntu.com/UbuntuGIS>, and/orosgeo4w
<http://trac.osgeo.org/osgeo4w/>ms4w
<http://www.maptools.org/ms4w/>, etc.)/
3. [marketing.3] The project incorporates OSGeo branding, such as
including an OSGeo logo on its website.
4. [marketing.4] The project has been registered with Open HUB, and
Open HUB has been updated to reference the correct code
repository(s) for the project.Open HUB
<https://www.openhub.net/>provides metrics to help assess the health
of a project.
Projects
1. [projects.1]Projects do not exist in isolation; and are expected to
communicate and collaborate on key issues.
/As an example, the PostGIS release procedure asks that the release
be checked with MapServer, GeoServer and others./
2. [projects.2] Where applicable, projects are expected to interoperate
effectively with other applications.
* [projects.2a] Interoperability is preferably achieved by
supporting relevant Open Standards.
* [projects.2b] Where applicable, standards compliance is verified
by executing compliance tests, such as provided by OGC CITE testing.
http://wiki.osgeo.org/wiki/Incubator_Application_Questionnaire
Incubator Application Questionnaire
1. Please describe your Project.
* What is its name?
* What is the home page URL?
* What does the application do and how does it add value to the
GeoSpatial stack of software?
* Does the application make use of OGC standards? Which standards?
You may wish to add comments about how standards are used.
* What language(s) are used in this project? (C/Java/perl/etc)
* What is the dominant written language (i.e. English, French,
Spanish, German, etc) of the core developers?
* What type of application does this project represent(client,
server, standalone, library, etc.)
* Please provide the name and email address of the principal
Project Owner. Ref:Project_Graduation_Checklist#board.1
<http://wiki.osgeo.org/wiki/Project_Graduation_Checklist#board.1>
2. Do you anticipate your project will encounter issues addressing the
criteria of theProject_Graduation_Checklist
<http://wiki.osgeo.org/wiki/Project_Graduation_Checklist>? Please
explain what areas need to be addressed in order to meet this criteria.
* Please provide the names and emails of co-project owners (if any).
* Please provide the names, emails and entity affiliation of all
official committers. Ref:Project_Graduation_Checklist#open.2b
<http://wiki.osgeo.org/wiki/Project_Graduation_Checklist#open.2b>
3. Why is OSGeo Incubation good for your project?
4. Please describe any relationships to other open source projects.
Ref:Project_Graduation_Checklist#Projects
<http://wiki.osgeo.org/wiki/Project_Graduation_Checklist#Projects>
5. Please describe any relationships with commercial companies or
products. Ref:Project_Graduation_Checklist#open.2b
<http://wiki.osgeo.org/wiki/Project_Graduation_Checklist#open.2b>
6. Please explain how your project will use an open governance policy,
ensuring decisions are made, documented and adhered to in a public
manner. Ref:Project_Graduation_Checklist#processes.2a
<http://wiki.osgeo.org/wiki/Project_Graduation_Checklist#processes.2a>
7. Which open source license(s) will the source code be released under?
Ref:Project_Graduation_Checklist#open.1a
<http://wiki.osgeo.org/wiki/Project_Graduation_Checklist#open.1a>
8. Please describe the maturity and history of your project. For instance,
* How long has your project been producing stable releases?
* What is the origin of your project (commercial, experimental,
thesis or other higher education, government, or some other source)?
* How many people actively contribute (code, documentation,
other?) to the project at this time?
Ref:Project_Graduation_Checklist#open.2b
<http://wiki.osgeo.org/wiki/Project_Graduation_Checklist#open.2b>
* How many people have commit access to the source code
repository? Ref:Project_Graduation_Checklist#open.2b
<http://wiki.osgeo.org/wiki/Project_Graduation_Checklist#open.2b>
* Approximately how many users are currently using this project?
* What type of users does your project attract (government,
commercial, hobby, academic research, etc. )?
9. Do you wish to host any portion of this project using the OSGeo
infrastructure? If so, what? Ref:Project_Graduation_Checklist#SAC
<http://wiki.osgeo.org/wiki/Project_Graduation_Checklist#SAC>
10. Does the project support open standards? Which ones and to what
extent? (OGC, w3c, etc.) Has the software been certified to any
standard (CITE for example)? If not, is it the intention of the
project owners to seek certification at some point?
Ref:Project_Graduation_Checklist#projects.2
<http://wiki.osgeo.org/wiki/Project_Graduation_Checklist#projects.2>
11. Is the code free of patents, trademarks, and do you control the
copyright?
Ref:Project_Graduation_Checklist#Project_Graduation_Checklist#Copyright_and_License
<http://wiki.osgeo.org/wiki/Project_Graduation_Checklist#Project_Graduation_Checklist.23Copyright_and_License>
12. Does the project include an automated build and test?
Ref:Project_Graduation_Checklist#release.2
<http://wiki.osgeo.org/wiki/Project_Graduation_Checklist#release.2>
13. What is the (estimated) size of a full release of this project? How
many users do you expect to download the project when it is released?
14. Do you already have an OSGeo Mentor to guide you through the
incubation process?
Deprecate:
http://wiki.osgeo.org/wiki/General_Principles_of_Incubation
On 30/11/2014 3:36 am, Jody Garnett wrote:
> Merging docs is a good idea, looks like we end up with one "initial
> application" document, and one "graduation / checklist" document.
>
> While merging please keep the checklist feel, we do have a FAQ page
> which can be used if you feel more discussion is warranted. Questions
> such as "appropriate standards" are difficult, since we would like to
> encourage projects to explore and work in areas that have not yet been
> standardized.
>
>
> Jody Garnett
>
> On Sat, Nov 29, 2014 at 5:49 AM, Cameron Shorter
> <cameron.shorter at gmail.com <mailto:cameron.shorter at gmail.com>> wrote:
>
> Hi all,
> As I start considering taking OSGeo-Live into OSGeo Incubation,
> I've audited our Incubation documents which have significant overlap.
>
> In particular, I think our Project Graduation Checklist is now
> quite comprehensive.
>
> I believe the General Principles of Incubation document can be
> retired, as material in it is covered by the Checklist.
>
> I think we probably should also retire the Incubation Application
> Questionnaire, moving a few project specific questions into the
> Project Graduation Checklist.
>
> To show the level of duplication between documents, I've inserted
> cross references into:
> http://wiki.osgeo.org/wiki/General_Principles_of_Incubation
> http://wiki.osgeo.org/wiki/Incubator_Application_Questionnaire#Questions
>
> These link to points in:
> http://wiki.osgeo.org/wiki/Project_Graduation_Checklist
>
> In doing this, I've also picked up some limitations with
> Graduation Checklist:
>
> 1. There is no question to see if there is feature complete,
> mature code, with at least one stable release.
>
> 2. There is no question to see if appropriate standards are being
> used.
>
> 3. While there are questions about developer and their
> affiliations, there isn't a question about the size of the user base.
>
> 4. We should move some of the "About this project" questions into
> the Checklist, to keep them in the same place.
>
> I'm interested to hear comment on whether merging docs into one is
> a good idea. If there is rough consensus that it is good, I'll put
> a proposal forward for a v3 Graduation Checklist.
>
> --
> Cameron Shorter,
> Software and Data Solutions Manager
> LISAsoft
> Suite 112, Jones Bay Wharf,
> 26 - 32 Pirrama Rd, Pyrmont NSW 2009
>
> P +61 2 9009 5000 <tel:%2B61%202%209009%205000>, W
> www.lisasoft.com <http://www.lisasoft.com>, F +61 2 9009 5099
> <tel:%2B61%202%209009%205099>
>
> _______________________________________________
> Incubator mailing list
> Incubator at lists.osgeo.org <mailto:Incubator at lists.osgeo.org>
> http://lists.osgeo.org/mailman/listinfo/incubator
>
>
--
Cameron Shorter,
Software and Data Solutions Manager
LISAsoft
Suite 112, Jones Bay Wharf,
26 - 32 Pirrama Rd, Pyrmont NSW 2009
P +61 2 9009 5000, W www.lisasoft.com, F +61 2 9009 5099
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/incubator/attachments/20141130/25df0fc4/attachment-0001.html>
More information about the Incubator
mailing list