Difference between revisions of "Contributing Examples (BIRT)"

From Eclipsepedia

Jump to: navigation, search
(Introduction)
 
(23 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
{{Backlink|Examples (BIRT)}}
 +
 
== Introduction ==  
 
== Introduction ==  
 
The BIRT Community appreciates your willingness to contribute examples.  Please consider adding or revising entries to assist other BIRT developers.
 
The BIRT Community appreciates your willingness to contribute examples.  Please consider adding or revising entries to assist other BIRT developers.
Line 4: Line 6:
 
To contribute an example to the BIRT wiki follow the guidelines below.
 
To contribute an example to the BIRT wiki follow the guidelines below.
  
*'''New Wiki Page''' - Create a wiki page with the title of your example.  The title should be formatted like “title (BIRT)”.  The reason for this convention is to optimize wiki usage and prevent name clashes with existing wiki pages.  The wiki is shared among many Eclipse projects.  Copy the wiki syntax listed under '''Sample Wiki Page''' and paste to your new page.
+
*'''New Wiki Page''' - Create a wiki page with the title of your example.  The title should be formatted like “title (BIRT)”.  The reason for this convention is to optimize wiki usage and prevent name clashes with existing wiki pages.  The wiki is shared among many Eclipse projects.  Copy the wiki syntax listed under '''Sample Wiki Page Syntax''' and paste to your new page.
  
*'''Example Files''' - If your example contains source code or an example report, create a bugzilla entry and upload the content as an attachment.  It is better if you compress the attachment and then place a link in the wiki example to the attachment within bugzilla. This link will be similar to <nowiki>[https://bugs.eclipse.org/bugs/attachment.cgi?id=57814 Example Report Zipped]</nowiki> and should be placed under the Example Files header within the wiki page.
+
*'''Example Files''' - Any code that is given to the BIRT project needs to be submitted through Bugzilla.  If your example contains source code or an example report, create a bugzilla entry and upload the content as an attachment.   
In the bugzilla entry you create specify “Example –“ name of your wiki page for the summary field.  For example, the summary field may contain “Example - Stored Procedure (BIRT)”.  In the Severity field, tag the bug as an Enhancement.
+
**TIP: The component field for a Wiki entry should be set to 'wiki'.  This will allow a committer to review your submission.
 +
**TIP: Summary field format is “Example – name of your wiki page" 
 +
***e.g. “Example - Stored Procedure (BIRT)”. 
 +
**TIP: In the Severity field, tag the bug as an Enhancement.
 +
**TIP: It is better if you compress the attachment and link to the attachment from the wiki entry\\ 
 +
***e.g. <nowiki>[https://bugs.eclipse.org/bugs/attachment.cgi?id=57814 Example Report Zipped]</nowiki> place under Example Files Header
  
*'''Link your new page''' – Navigate to the most logical place within the wiki example structure and edit the page.  Place a link to your new page.
+
*'''Link your new page''' – Navigate to the most logical place within the wiki example structure and edit the page.  Place a link to your new page.  If you need help as to where the link to your example should be, please note in the Bugzilla entry and a committer will help you locate the link.
  
 
+
== Sample Wiki Page Syntax ==
 
+
<tt><blockquote>
== Sample Wiki Page ==
+
<nowiki>{{Backlink|Report Developer Examples (BIRT)}}</nowiki>
 +
<br>
 +
<nowiki>This example is
 +
[https://bugs.eclipse.org/bugs/show_bug.cgi?id=XXXXXX Bugzilla ID XXXXX].  If you would like to contribute an
 +
example see the example contribution guidelines.<br></nowiki><br>
 
<nowiki>
 
<nowiki>
 
== Introduction ==
 
== Introduction ==
 
</nowiki><br>
 
</nowiki><br>
 
+
Add your introduction here.<br>
Add your introduction here.
+
 
+
 
<nowiki>
 
<nowiki>
 
== BIRT Version Compatibility ==  
 
== BIRT Version Compatibility ==  
 
</nowiki><br>
 
</nowiki><br>
Enter the version of BIRT that was used to build the example.
+
Enter the version of BIRT that was used to build the example.<br>
 
+
 
<nowiki>
 
<nowiki>
 
== Example Files==  
 
== Example Files==  
 
</nowiki><br>
 
</nowiki><br>
Add a URL to your bugzilla attachment. eg.
+
Add a URL to your bugzilla attachment. eg.<br>
 
<nowiki>
 
<nowiki>
[https://bugs.eclipse.org/bugs/attachment.cgi?id=57814 Example Report Zipped]
+
[https://bugs.eclipse.org/bugs/attachment.cgi?id=YYYYYY Example Report Zipped]
 
</nowiki><br>
 
</nowiki><br>
 
<nowiki>
 
<nowiki>
 
== Description==
 
== Description==
 
</nowiki><br>
 
</nowiki><br>
Give a detailed description of your example.
+
Give a detailed description of your example.<br>
 
<nowiki>
 
<nowiki>
 
== Comments ==
 
== Comments ==
 
</nowiki><br>
 
</nowiki><br>
Please enter comments below by selecting the edit icon to the right.
+
Please enter comments below by selecting the edit icon to the right.<br>
You will need a Bugzilla account to add comments.
+
You will need a Bugzilla account to add comments.<br>
<nowiki>
+
<nowiki>----</nowiki><br>
----
+
<nowiki>[[Category:BIRT]]</nowiki><br>
</nowiki>
+
<nowiki>[[Category:BIRT Example]]</nowiki><br>
 +
<nowiki>[[Category:BIRT Example Report]]</nowiki><br>
 +
<nowiki> or </nowiki><br>
 +
<nowiki>[[Category:BIRT]]</nowiki><br>
 +
<nowiki>[[Category:BIRT Example]]</nowiki><br>
 +
<nowiki>[[Category:BIRT Example Integration]]</nowiki><br>
 +
<nowiki> or </nowiki><br>
 +
<nowiki>[[Category:BIRT]]</nowiki><br>
 +
<nowiki>[[Category:BIRT Example]]</nowiki><br>
 +
<nowiki>[[Category:BIRT Example Extension]]</nowiki><br>
 +
</blockquote></tt>
 +
 
 +
[[Category:BIRT]]
 +
[[Category:BIRT Example]]

Latest revision as of 14:53, 22 June 2007

< To: Examples (BIRT)

[edit] Introduction

The BIRT Community appreciates your willingness to contribute examples. Please consider adding or revising entries to assist other BIRT developers.

To contribute an example to the BIRT wiki follow the guidelines below.

  • New Wiki Page - Create a wiki page with the title of your example. The title should be formatted like “title (BIRT)”. The reason for this convention is to optimize wiki usage and prevent name clashes with existing wiki pages. The wiki is shared among many Eclipse projects. Copy the wiki syntax listed under Sample Wiki Page Syntax and paste to your new page.
  • Example Files - Any code that is given to the BIRT project needs to be submitted through Bugzilla. If your example contains source code or an example report, create a bugzilla entry and upload the content as an attachment.
    • TIP: The component field for a Wiki entry should be set to 'wiki'. This will allow a committer to review your submission.
    • TIP: Summary field format is “Example – name of your wiki page"
      • e.g. “Example - Stored Procedure (BIRT)”.
    • TIP: In the Severity field, tag the bug as an Enhancement.
    • TIP: It is better if you compress the attachment and link to the attachment from the wiki entry\\
      • e.g. [https://bugs.eclipse.org/bugs/attachment.cgi?id=57814 Example Report Zipped] place under Example Files Header
  • Link your new page – Navigate to the most logical place within the wiki example structure and edit the page. Place a link to your new page. If you need help as to where the link to your example should be, please note in the Bugzilla entry and a committer will help you locate the link.

[edit] Sample Wiki Page Syntax

{{Backlink|Report Developer Examples (BIRT)}}
This example is [https://bugs.eclipse.org/bugs/show_bug.cgi?id=XXXXXX Bugzilla ID XXXXX]. If you would like to contribute an example see the example contribution guidelines.<br>
== Introduction ==
Add your introduction here.
== BIRT Version Compatibility ==
Enter the version of BIRT that was used to build the example.
== Example Files==
Add a URL to your bugzilla attachment. eg.
[https://bugs.eclipse.org/bugs/attachment.cgi?id=YYYYYY Example Report Zipped]
== Description==
Give a detailed description of your example.
== Comments ==
Please enter comments below by selecting the edit icon to the right.
You will need a Bugzilla account to add comments.
----
[[Category:BIRT]]
[[Category:BIRT Example]]
[[Category:BIRT Example Report]]
or
[[Category:BIRT]]
[[Category:BIRT Example]]
[[Category:BIRT Example Integration]]
or
[[Category:BIRT]]
[[Category:BIRT Example]]
[[Category:BIRT Example Extension]]