org.eclipse.dash.handbook issueshttps://gitlab.eclipse.org/eclipse/technology/dash/org.eclipse.dash.handbook/-/issues2020-11-25T19:33:51Zhttps://gitlab.eclipse.org/eclipse/technology/dash/org.eclipse.dash.handbook/-/issues/36Add FAQ regarding multiple Git repositories2020-11-25T19:33:51ZEclipse WebmasterAdd FAQ regarding multiple Git repositories## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#500425)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=500425)**
## Description
Projects can have more than one repository. How many is a bit of an "it depends" sort ...## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#500425)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=500425)**
## Description
Projects can have more than one repository. How many is a bit of an "it depends" sort of question. If they host on an EF-maintained Git server, they can create as many repositories as they'd like. If they host on GitHub, the webmaster has to create the repositories on their behalf and since this is time consuming, we look to a project team to "be reasonable".
We probably should add some sort of advice regarding "right sizing" repositories as well.https://gitlab.eclipse.org/eclipse/technology/dash/org.eclipse.dash.handbook/-/issues/35Add content regarding the use of third-party services2020-11-25T19:33:49ZEclipse WebmasterAdd content regarding the use of third-party services## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#499792)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=499792)**
## Description
Projects are required to use Eclipse Foundation services for all core services. Projec...## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#499792)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=499792)**
## Description
Projects are required to use Eclipse Foundation services for all core services. Project teams may want to use other services. We need to provide some guidance.https://gitlab.eclipse.org/eclipse/technology/dash/org.eclipse.dash.handbook/-/issues/34Update content related to IP Policy in the Handbook2020-11-25T19:33:46ZEclipse WebmasterUpdate content related to IP Policy in the Handbook## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#499707)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=499707)**
## Description
With changes coming to the IP Policy, we need to update the handbook. This is a placeh...## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#499707)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=499707)**
## Description
With changes coming to the IP Policy, we need to update the handbook. This is a placeholder for now: I need to work out what, exactly, needs to change.
### Depends on
* [Bug 498290](https://bugs.eclipse.org/bugs/show_bug.cgi?id=498290)
* [Bug 508554](https://bugs.eclipse.org/bugs/show_bug.cgi?id=508554)
* [Bug 439531](https://bugs.eclipse.org/bugs/show_bug.cgi?id=439531)
* [Bug 508207](https://bugs.eclipse.org/bugs/show_bug.cgi?id=508207)
* [Bug 509114](https://bugs.eclipse.org/bugs/show_bug.cgi?id=509114)
* [Bug 509610](https://bugs.eclipse.org/bugs/show_bug.cgi?id=509610)
* [Bug 510376](https://bugs.eclipse.org/bugs/show_bug.cgi?id=510376)
* [Bug 512465](https://bugs.eclipse.org/bugs/show_bug.cgi?id=512465)
### Blocking
* [Bug 496959](https://bugs.eclipse.org/bugs/show_bug.cgi?id=496959)https://gitlab.eclipse.org/eclipse/technology/dash/org.eclipse.dash.handbook/-/issues/33Update the IP cartoons and move them to the handbook2020-11-25T19:33:43ZEclipse WebmasterUpdate the IP cartoons and move them to the handbook## Submitted by Jens Reimann
**[Link to original bug (#498290)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=498290)**
## Description
The cartoon mentions Gerrit und Bugzilla but not GitHub.
### Blocking
* [Bug 499707](https://...## Submitted by Jens Reimann
**[Link to original bug (#498290)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=498290)**
## Description
The cartoon mentions Gerrit und Bugzilla but not GitHub.
### Blocking
* [Bug 499707](https://bugs.eclipse.org/bugs/show_bug.cgi?id=499707)https://gitlab.eclipse.org/eclipse/technology/dash/org.eclipse.dash.handbook/-/issues/32Add help for committers to determine whether or not a CQ is required for proj...2020-11-25T19:33:41ZEclipse WebmasterAdd help for committers to determine whether or not a CQ is required for project code## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#497519)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=497519)**
## Description
We do have help for third-party libraries [1].
My primary concern with adding more he...## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#497519)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=497519)**
## Description
We do have help for third-party libraries [1].
My primary concern with adding more help for project code contributions is that I believe that this is reasonably well covered by the IP Due Diligence document. Any attempt to duplicate that information must carefully avoid adding confusion or falling out synch.
[1] https://www.eclipse.org/projects/handbook/#ip-third-partyhttps://gitlab.eclipse.org/eclipse/technology/dash/org.eclipse.dash.handbook/-/issues/31Guidance regarding the distribution of software via alternative means2020-11-25T19:33:39ZEclipse WebmasterGuidance regarding the distribution of software via alternative means## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#496429)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=496429)**
## Description
It would be useful for the architecture council to provide the Eclipse Foundation with...## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#496429)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=496429)**
## Description
It would be useful for the architecture council to provide the Eclipse Foundation with guidance on what we need to do to support their project downloads. We are currently set up to provide actual downloads of bits in, say, ZIP format.
How, for example, can we support projects that want to make available Docker containers, or npm or Maven Central?
What, if anything, must be hosted on EF resources?
Can a resource that's not hosted by the EF be considered an "official" distribution channel?
Is the word "downloads" confusing when, for example, linking to hosted solutions? (e.g. OrionHub)
Does the policy regarding linking to non-eclipse.org resources provide enough information?
[1] https://wiki.eclipse.org/Links_to_non-eclipse.org_contenthttps://gitlab.eclipse.org/eclipse/technology/dash/org.eclipse.dash.handbook/-/issues/30Include discussion of the Security Policy in the handbook2022-10-17T19:16:05ZEclipse WebmasterInclude discussion of the Security Policy in the handbook## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#496426)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=496426)**
## Description
We may only need a pointer. But we should have that pointer.
### Depends on
* [Bug ...## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#496426)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=496426)**
## Description
We may only need a pointer. But we should have that pointer.
### Depends on
* [Bug 496425](https://bugs.eclipse.org/bugs/show_bug.cgi?id=496425)
* [Bug 514571](https://bugs.eclipse.org/bugs/show_bug.cgi?id=514571)
### Blocking
* [Bug 510142](https://bugs.eclipse.org/bugs/show_bug.cgi?id=510142)
* [Bug 511789](https://bugs.eclipse.org/bugs/show_bug.cgi?id=511789)https://gitlab.eclipse.org/eclipse/technology/dash/org.eclipse.dash.handbook/-/issues/29Add a "New Committer Orientation" section to the handbook2020-11-25T19:33:33ZEclipse WebmasterAdd a "New Committer Orientation" section to the handbook## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#496029)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=496029)**
## Description
Provide a concise overview of what new committers need to know with pointers into the ...## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#496029)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=496029)**
## Description
Provide a concise overview of what new committers need to know with pointers into the documentation.https://gitlab.eclipse.org/eclipse/technology/dash/org.eclipse.dash.handbook/-/issues/28Add documentation to describe including multiple subprojects with a release2020-11-25T19:33:31ZEclipse WebmasterAdd documentation to describe including multiple subprojects with a release## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#495692)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=495692)**
## Description
When a project chooses to include subprojects with a release, we have a means of captu...## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#495692)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=495692)**
## Description
When a project chooses to include subprojects with a release, we have a means of capturing that in the release record. This information is used currently as a hint to the IP Log generator to include those subprojects when it generates.
We should provide documentation of this in both the section on using the PMI to capture release information and as a FAQ entry in the IP Log generator section.
This impacts relatively few projects (Eclipse, Data Tools, Mylyn, and Web Tools), but is still important information.https://gitlab.eclipse.org/eclipse/technology/dash/org.eclipse.dash.handbook/-/issues/27Provide more explicit description and pointers for creating CQs2020-11-25T19:33:29ZEclipse WebmasterProvide more explicit description and pointers for creating CQs## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#494957)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=494957)**
## Description
The handbook currently only provides general information about creating CQs. It should...## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#494957)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=494957)**
## Description
The handbook currently only provides general information about creating CQs. It should provide very specific information and pointers.
Ideally, we should provide some forge-specific screen shots.
### Blocking
* [Bug 494953](https://bugs.eclipse.org/bugs/show_bug.cgi?id=494953)https://gitlab.eclipse.org/eclipse/technology/dash/org.eclipse.dash.handbook/-/issues/26Add documentation for the new IP Log Generator2020-11-25T19:33:26ZEclipse WebmasterAdd documentation for the new IP Log Generator## Submitted by Ed Willink
**[Link to original bug (#493967)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=493967)**
## Description
The tool directs to:
https://wiki.eclipse.org/PMI/IP_Log_Generator
in the generated title:
The I...## Submitted by Ed Willink
**[Link to original bug (#493967)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=493967)**
## Description
The tool directs to:
https://wiki.eclipse.org/PMI/IP_Log_Generator
in the generated title:
The IP Log Generator gathers information from several sources. For more information on those sources and how to change values in this generated log, please see The IP Log Generator in the wiki. Note that this preview can only be accessed by project team members.
the referenced page is a dummy, so how to change?https://gitlab.eclipse.org/eclipse/technology/dash/org.eclipse.dash.handbook/-/issues/25Single mentor only required.2020-11-25T19:33:25ZEclipse WebmasterSingle mentor only required.## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#491836)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=491836)**
## Description## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#491836)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=491836)**
## Descriptionhttps://gitlab.eclipse.org/eclipse/technology/dash/org.eclipse.dash.handbook/-/issues/24Add discussion of what to expect when transitioning an existing project2024-01-15T20:35:32ZEclipse WebmasterAdd discussion of what to expect when transitioning an existing project## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#491835)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=491835)**
## Description
We need some discussion of what existing projects should expect when transitioning to ...## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#491835)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=491835)**
## Description
We need some discussion of what existing projects should expect when transitioning to Eclipse/LocationTech/PolarSys. This belongs in the "Starting a New Open Source Project" section.
e.g.
Projects transitioning to Eclipse are required to:
* Transfer ownership any existing project name to the EF;
* Transfer existing domain names that use the project name trademark to the EF;
* Conform to the Eclipse Logo & Trademark usage guidelines on project websites and in communication with the community (e.g. in slide decks);
* Conform to the Eclipse Development Process;
* Conform to the Eclipse IP Policy and follow the Eclipse IP Due Diligence Process;
* Maintain metadata pertaining to the project using the EF-provided PMI;
* Use EF-provided VCS for all project source code;
* Host binary distributions from EF-provided downloads server; and
* Use EF-provided web hosting services for the project's primary website.
Note that other services can be used in addition to EF-provided ones, but the EF provided ones must be considered canonical.
Projects are expected spend effort engaging with their community, and court contributions and new developers. Projects are also encouraged to provide mature automated build solutions, maintain both user and contributor documentation, and otherwise engage in activities that encourage participation in the project.
New project sponsors must engage in the process of transitioning an existing project with the intent to continue development of the project code and growth of the community and ecosystem around the project.https://gitlab.eclipse.org/eclipse/technology/dash/org.eclipse.dash.handbook/-/issues/23The requirements in terms of legal documentation must be documented2020-11-25T19:33:21ZEclipse WebmasterThe requirements in terms of legal documentation must be documented## Submitted by Benjamin Cabé
**[Link to original bug (#491086)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=491086)**
## Description
I think at least some of the contents of https://eclipse.org/legal/guidetolegaldoc.php would des...## Submitted by Benjamin Cabé
**[Link to original bug (#491086)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=491086)**
## Description
I think at least some of the contents of https://eclipse.org/legal/guidetolegaldoc.php would deserve to be migrated to the Handbook.
I haven't been able to find anything more recent than 2008 (namely, the aforementioned link) in terms of documenting what needs to be done regarding notice.html, providing a copy of the EPL(/EDL), about.html, ...
### Depends on
* [Bug 498155](https://bugs.eclipse.org/bugs/show_bug.cgi?id=498155)
### Blocking
* [Bug 519789](https://bugs.eclipse.org/bugs/show_bug.cgi?id=519789)https://gitlab.eclipse.org/eclipse/technology/dash/org.eclipse.dash.handbook/-/issues/22Describe how to create a contribution questionnaire2020-11-25T19:33:17ZEclipse WebmasterDescribe how to create a contribution questionnaire## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#489588)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=489588)**
## Description
The process for creating a CQ needs to be described in the handbook.
This is describe...## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#489588)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=489588)**
## Description
The process for creating a CQ needs to be described in the handbook.
This is described in the wiki, we need to transfer this to the handbook.
https://wiki.eclipse.org/Project_Management_Infrastructure/Creating_A_Contribution_Questionnaire
Note that the wiki shows the link as being in the tray.
We need to enable this functionality in the LocationTech and PolarSys PMI instances. I'll open separate bugs for this.
### Depends on
* [Bug 489590](https://bugs.eclipse.org/bugs/show_bug.cgi?id=489590)https://gitlab.eclipse.org/eclipse/technology/dash/org.eclipse.dash.handbook/-/issues/21Move incubation branding requirements into handbook2020-11-25T19:33:15ZEclipse WebmasterMove incubation branding requirements into handbook## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#488421)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=488421)**
## Description
The handbook already includes much of the content in the "Project Phases" section. Thi...## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#488421)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=488421)**
## Description
The handbook already includes much of the content in the "Project Phases" section. This should be pulled out into its own section.
https://www.eclipse.org/projects/handbook/#starting-project-phases
The wiki page should be scavenged for any other germane information and retired.
https://wiki.eclipse.org/Development_Resources/HOWTO/Conforming_Incubation_Brandinghttps://gitlab.eclipse.org/eclipse/technology/dash/org.eclipse.dash.handbook/-/issues/20Add discussion regarding a CONTRIBUTING(.md)? file2020-11-25T19:33:13ZEclipse WebmasterAdd discussion regarding a CONTRIBUTING(.md)? file## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#487547)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=487547)**
## Description
Base the content on this:
https://wiki.eclipse.org/Architecture_Council/Contributor_G...## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#487547)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=487547)**
## Description
Base the content on this:
https://wiki.eclipse.org/Architecture_Council/Contributor_Guide_Recommendationhttps://gitlab.eclipse.org/eclipse/technology/dash/org.eclipse.dash.handbook/-/issues/19Move more of the Initial Contribution content into the handbook2020-11-25T19:33:11ZEclipse WebmasterMove more of the Initial Contribution content into the handbook## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#487246)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=487246)**
## Description
The wiki provides a little more detail on initial contributions that would be a valuab...## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#487246)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=487246)**
## Description
The wiki provides a little more detail on initial contributions that would be a valuable addition to the handbook.
https://wiki.eclipse.org/Development_Resources/Initial_Contribution
Move this content and update the wiki.
### Depends on
* [Bug 494955](https://bugs.eclipse.org/bugs/show_bug.cgi?id=494955)
* [Bug 488237](https://bugs.eclipse.org/bugs/show_bug.cgi?id=488237)https://gitlab.eclipse.org/eclipse/technology/dash/org.eclipse.dash.handbook/-/issues/18Update discussion regarding GitHub2020-11-25T19:33:09ZEclipse WebmasterUpdate discussion regarding GitHub## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#487243)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=487243)**
## Description
The handbook currently says "Projects that host source code on GitHub are not permitte...## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#487243)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=487243)**
## Description
The handbook currently says "Projects that host source code on GitHub are not permitted to use GitHub Issues or Wiki."
This is no longer true.
### Blocking
* [Bug 481771](https://bugs.eclipse.org/bugs/show_bug.cgi?id=481771)https://gitlab.eclipse.org/eclipse/technology/dash/org.eclipse.dash.handbook/-/issues/17Provide guidance regarding project logos in the handbook2020-11-25T19:33:07ZEclipse WebmasterProvide guidance regarding project logos in the handbook## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#485966)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=485966)**
## Description
The short version:
The project logo is intellectual property, so be sure that you're ...## Submitted by Wayne Beaton `@wbeaton`
**[Link to original bug (#485966)](https://bugs.eclipse.org/bugs/show_bug.cgi?id=485966)**
## Description
The short version:
The project logo is intellectual property, so be sure that you're not infringing on anybody's trademark or copyright.
Logos are not typically shipped as project code, so you don't generally need to get IP Team approval.
If the logo incorporates the Eclipse Logo, you'll need to get board approval.
### Depends on
* [Bug 498236](https://bugs.eclipse.org/bugs/show_bug.cgi?id=498236)