Wiki code for Project Set-Up

Hide Line numbers
1: = Instructions for Setting Up a Project on opensolaris.org
2: 
3: After your project is approved by following the [[project request process>>attach:Community Group ogb.policies@project-instantiation.txt]], read the following instructions and rules about populating web pages and posting binaries and/or source on opensolaris.org.
4: 
5: Information about managing your Project moving forward can be found on the [[Project Lead Reference>>Main.lead_reference]] page.
6: 
7: == Process and Information
8: 
9: === Approvals
10: 
11: If you are a Sun engineering team that is moving a pre-existing, completed project from inside Sun to opensolaris.org, you must use [[internal processes>>http://opensourcereview.central.sun.com]] to get approval to do this.
12: 
13: === Trademarks
14: 
15: Solaris and OpenSolaris are trademarks of Sun Microsystems, Inc. that are used to identify Sun products/services. They are used as an adjective, followed by an appropriate noun. It is best/safest to not use these on community and project web pages, particularly in titles.
16: 
17: If you represent a Sun engineering team that is using a code name, that name must be cleared (i.e., approved) for use on this site. It’s better/easier not to use code names. Instead, use generic, descriptive words to title your project.
18: 
19: Detail about Sun’s trademarks and fair use of them can be found on the [[Trademarks>>http://www.sun.com/policies/trademarks/]] page.
20: 
21: === License Choice
22: 
23: Brand new projects started and developed on opensolaris.org use the [[Common Development and Distribution License>>Main.opensolaris_license]] (CDDL). Prototype files containing the CDDL comment block can be found in the [[prototypes directory>>http://src.opensolaris.org/source/xref/onnv/onnv-gate/usr/src/prototypes/]] of the ON consolidation source hierarchy.
24: 
25: If Sun engineers participate in the project, no internal processes are required as long as [[internal guidelines>>http://opensourcereview.central.sun.com]] are followed.
26: 
27: If a new project is started that uses existing, published open source software, license information must be provided as noted below. If Sun engineers participate in the project, Sun [[internal processes>>http://opensourcereview.central.sun.com]] must be followed.
28: 
29: === License Documentation
30: 
31: **Wherever** information available for download is referenced, licensing information **must** be posted and/or referenced so applicable licenses can be evaluated prior to downloading anything. This usually means at least two places: the page that points to information available for download, and the page that contains the information that can be downloaded. For example, if code is available for download on the Download Center and a Project page points to the Download Center, both the Download Center page and the Project page must contain licensing information. If the code available for download is small and is posted directly on a Project page, only that page needs the license information.
32: 
33:  Sample Text:
34:  The NAME (code/tool/component/library/source) is provided under the LICENSE license.
35: 
36:  Where
37:  NAME = the name of the code/tool/component/library/source;
38:  LICENSE = name of the license (or well-known acronym) linked to the license text.
39: 
40: === Sun Contributor Agreement
41: 
42: A [[Sun Contributor Agreement>>Main.sun_contributor_agreement]] must be on file before source or binaries from an external community member is/are posted on opensolaris.org. "Posting" includes integrating source code changes to a source repository or posting source or binaries using tarballs or adding information to web pages.
43: 
44: === Bug Categories/Subcategorires
45: 
46: When a project is moved from inside the Sun firewall to opensolaris.org, associated bug database categories/subcategories need to be made available via [[bugs.opensolaris.org>>http://bugs.opensolaris.org/]]. Sun engineers are responsible for reviewing all bug database categories/subcategories to prepare them for availability. Then send email to **oso-admin AT opensolaris DOT org** with a list of the product/categories to add to bugs.opensolaris.org. All associated sub-categories will be made available unless explicitly noted in the email that one or more should not be made available.
47: 
48: == Posting Locations
49: 
50: Tarballs and ISO images can be posted in two places
51: 
52: * **If less than 15M**, they can be posted directly on a project webpage.
53: * **If larger than 15M**, they need to be posted on the [[Download Center>>http://dlc.sun.com/osol]].
54: 
55: Currently, only Sun employees can post directly to the Download Center. If you are not a Sun employee, please contact someone on your project who is. Sun employees should read the [[internal webpage>>http://tonic.eng.sun.com/xwiki/bin/view/Main/Posting+Detail]] for instructions about posting on the download center.
56: 
57: A mechanism will be available at a later date to allow everyone to post directly to the Download Center.
58: 
59: **REMINDER**: License information must be provided wherever there is a download or pointer to a download. See instructions above under "License Documentation."
60: 
61: == Posting Binaries
62: 
63: ONLY BINARIES THAT CAN BE FREELY RE-DISTRIBUTED BY ANYONE MAY BE POSTED ON opensolaris.org. Sun employees must read the additional posting instructions on the [[internal webpage>>http://tonic.eng.sun.com/xwiki/bin/view/Main/Posting+Detail]] for instructions and information about publishing binaries on opensolaris.org.
64: 
65: **FOR SUN EMPLOYEES ONLY**: See the [[internal webpage>>http://tonic.eng/xwiki/bin/view/Main/Publishing]] for instructions about publishing binaries built from pre-existing Sun source code that is not available as open source yet.
66: 
67: === Licensing Information
68: 
69: Create a tarball that contains the binaries and also the following licensing information:
70: 
71: * If using the [[OpenSolaris Binary License>>Main.opensolaris_binary_license]]
72: ** Include a text file that contains the text of the OpenSolaris Binary License.  Name this file: BINARYLICENSE.txt.  This file can be created using the [[OpenSolaris Binary License text file>>attach:binarylicense.txt]].
73: ** Include a file named: README.tarballname.arch.  See the [[README template>>attach:readme.template]] for information about the contents of this file and instructions about how to populate it.
74: ** If some binaries are covered by other licenses, include a file named: THIRDPARTYLICENSE.tarballname.  See [[THIRDPARTYLICENSE template>>attach:thirdpartylicense.template]] for information about the contents of this file and instructions about how to populate it.
75: * If using the [[CDDL>>Main.opensolaris_license]]
76: ** If the binaries were built using only source covered by the CDDL, the binaries are also covered by the CDDL.  A text file must be included with the source that contains the license text.  Such a file can be created using the [[CDDL text file>>attach:opensolaris.license.txt]]
77: * If using one or more different **open source** licenses
78: ** If the binaries were built using one or more third-party open source licenses, all requirements of the license(s) must be met, and one or more files containing appropriate license text must be included in the tarball.
79: 
80: === Tarball Naming Conventions
81: 
82: In the examples below, the following definitions apply.
83: 
84: * ABBREVIATION = consolidation abbreviation/name
85: * DESCRIPTION = description of the subset of this consolidation, if applicable
86: * NAME = [project choice]
87: * DATE = YYYYMMDD
88: * ARCH = i386/sparc/ppc
89: 
90: * For Consolidations providing Binaries built from open source
91: ** ABBREVIATION[-DESCRIPTION]-bins-DATE.ARCH.tar.bz2
92: ** EXAMPLES:
93: *** devpro-libm-bins-20051213.sparc.tar.bz2
94: *** nws-bins-20051127.i386.tar.bz2
95: * For Consolidations providing Binaries built from non-open source
96: ** ABBREVIATION[-DESCRIPTION]-closed-bins-DATE.ARCH.tar.bz2
97: ** EXAMPLES:
98: *** on-closed-bins-20060102.sparc.tar.bz2
99: *** nws-closed-bins-20051127.i386.tar.bz2
100: * For Projects providing Binaries built from open source
101: ** NAME-bins-DATE.ARCH.tar.bz2
102: * For Projects providing binaries built from non-open source
103: ** NAME-closed-bins-DATE.ARCH.tar.bz2
104: 
105: == Posting Source
106: 
107: //**NOTE:**Tarballs should only be provided as a convenience or if the associated consolidation gate is inside the Sun firewall. New projects should be started in the open with source code repositories on opensolaris.org. Existing projects with project gates inside the Sun firewall should be moving source repositories to opensolaris.org. The following information is about tarballs and manual posting processes. Instructions for creating source repositories can be found on the [[Project Lead Reference>>Main.lead_reference]] page.//
108: 
109: **FOR SUN EMPLOYEES ONLY**: See the [[internal webpage>>http://tonic.eng/xwiki/bin/view/Main/Publishing]] for instructions about publishing pre-existing Sun source code.
110: 
111: === Licensing Information
112: 
113: Create a tarball that contains the source hierarchy, release notes or a README file that explains the source hierarchy, dependency information, build instructions, etc. and also the following licensing information:
114: 
115: * If using the [[CDDL>>Main.opensolaris_license]]
116: ** Include a text file at the top of the source hierarchy that contains the text of the CDDL. This file can be created using the [[CDDL text file>>attach:opensolaris.license.txt]]
117: ** Make sure the CDDL comment block in the code references the correct name and location of the license text file in your hierarchy.
118: * If using the [[Public Documentation License>>Main.pdl]] (for documentation source)
119: ** Include a text file at the top of the source hierarchy that contains the full license text of the PDL.  Such a file can be created using the [[PDL text file>>attach:pdl.txt]]
120: 
121: 
122: === Tarball Naming Conventions
123: 
124: In the examples below, the following definitions apply.
125: 
126: * ABBREVIATION = consolidation abbreviation/name
127: * DESCRIPTION = description of the subset of this consolidation, if applicable
128: * NAME = [project choice]
129: * DATE = YYYYMMDD
130: 
131: * For Consolidations
132: ** ABBREVIATION[-DESCRIPTION]-src-DATE.tar.bz2
133: ** EXAMPLES:
134: *** on-src-20060102.tar.bz2
135: *** devpro-libm-src-20051213.tar.bz2
136: *** nws-src-20051127.tar.bz2
137: * For Projects
138: ** NAME-src-DATE.tar.bz2
OpenSolaris

Top Menu

Wiki code for Project Set-Up

Search

Collectives

Community Group

Project

User Group

Subsites

Main Pages
