Difference between revisions of "Dextrose/Getting Involved"

Latest revision as of 00:39, 17 May 2016

NOTE:
The content of this page is considered
DEPRECATED and OBSOLETE
It is preserved for historical research, along with its talk page.

Moved and died at https://sugardextrose.org/projects/dextrose/wiki/Testing_and_reporting_issues

Dextrose · Get Involved · Contacts · Resources · FAQ · Roadmap · To Do · Meetings

Development

If you want to create custom images, see the documentation of the Dextrose build system.

Testing

Feedback from the entire community is appreciated.

Reporting bugs upstream

If you know the specific upstream project that contains the bug, please file your report into their bug tracker:

Sugar and activities: http://bugs.sugarlabs.org/
Drivers and OLPC customizations: http://dev.laptop.org/
Fedora OS: http://bugzilla.redhat.com/

When you file a bug on any component which affects Dextrose, please bring it to our attention by marking it with the "dextrose" keyword and by Cc'ing the Dextrose Release Manager.

Reporting bugs specific to Dextrose

You can file bugs specific to Dextrose in the Sugar Labs bug tracker and assign them to component "Dextrose". You can use this component when you're in doubt, the maintainers will reassign it to the correct component.

Before you file a new bug, please check the Summary of all bugs affecting Dextrose to avoid duplicates. You can comment on existing bugs to provide additional details.

Test plans

We currently don't have a formal test plan for Dextrose. We're looking for someone to help us coordinate our QA effort. These are some useful starting points:

SoaS V4 Activity Test Table (2010)
0.88 test plan from Paraguay Educa (incomplete, 2010)
OLPC 8.2.0 (aka os801): Test Cases, Test Results (obsolete, 2008)
OLPC testing matrix (obsolete, 2007)

@@ Line 1: / Line 1: @@
-<noinclude>{{GoogleTrans-en}}{{TeamHeader|Dextrose|home=Dextrose|xbgColor=ffe792|join_label=Get Involved}}</noinclude>
+{{Obsolete | Moved and died at https://sugardextrose.org/projects/dextrose/wiki/Testing_and_reporting_issues }}
-== F11-XO1 ==
+<noinclude>
+{{TeamHeader|Dextrose|home=Dextrose|xbgColor=ffe792|join_label=Get Involved}}
-We use [http://wiki.laptop.org/go/OS_Builder olpc-os-builder], a tool
+[[Category:Project]]
-used by OLPC to create official and customized system images.
+[[Category:SIG]]
+</noinclude>
-Our version contains local customizations specific to Paraguay and some
-patches that should be upstreamed.
-== How to create a build ==
-We cook our builds on [[Machine/robbie]], which is Fedora 11 i386.
-I could create builds also on my laptop, which runs Fedora 12 x86_64.
-What the host system runs shouldn't matter much, because all the work
-is being done in a chroot environment.
-* Checkout our local tree:
-  git clone git://git.sugarlabs.org/dextrose/mainline.git
-* One time preparation
-  yum upgrade
-  yum install libtomcrypt-devel bitfrost make gcc mtd-utils
-  make
-* Build:
-  time sudo ./osbuilder.py examples/f11-xo1-py.ini
-* Wait 15 minutes
-* Serve hot
-== Signing ==
-* Put the 4 signing keys somewhere in your home:
- bernie@robbie:~$ ll src/olpc/keys/
+== Development ==
- -rw-------. 1 bernie bernie 1,2K Feb  5  2009 pyo1.private
- -rw-------. 1 bernie bernie  270 Feb  5  2009 pyo1.public
- -rw-------. 1 bernie bernie 1,2K Feb  5  2009 pys1.private
- -rw-------. 1 bernie bernie  270 Feb  5  2009 pys1.public
- -rw-------. 1 bernie bernie 1,2K Feb  5  2009 pyw1.private
- -rw-------. 1 bernie bernie  270 Feb  5  2009 pyw1.public
-* Make sure the keys are '''NOT''' world-readable
+If you want to create custom images, see the documentation of the [[Dextrose/Building|Dextrose build system]].
-* Edit the paths in the <tt>[signing]</tt> section of <tt>examples/f11-xo1-py.ini</tt>
+== Testing ==
+Feedback from the entire community is appreciated.
-== Publishing the images ==
+=== Reporting bugs upstream ===
-I'm currently publishing selected builds in [http://oficina.paraguayeduca.org/~bernie/f11-xo1-py/ my public html folder].
+If you know the specific upstream project that contains the bug, please file your report into their bug tracker:
-Signed builds should be published only if they implement the OLPC anti-theft system
+* Sugar and activities: http://bugs.sugarlabs.org/
-([http://wiki.laptop.org/go/Antitheft_HowTo OATS]). Signing does
+* Drivers and OLPC customizations: http://dev.laptop.org/
-not have anything to do with quality or endorsement (i.e. signed builds are not
+* Fedora OS: http://bugzilla.redhat.com/
-necessarily bug-free).
-* TODO: We don't have a place for publishing official images yet
+When you file a bug on any component which affects Dextrose, please bring it to our
+attention by marking it with the "dextrose" keyword and by Cc'ing the [[Dextrose/Contacts|Dextrose Release Manager]].
-* TODO: We don't have a procedure for releasing builds to field technicians (we may use repo.paraguayeduca.org in the future)
+=== Reporting bugs specific to Dextrose ===
-* TODO: We don't keep release notes for our builds (we should probably use the wiki)
+You can file bugs specific to Dextrose in the [http://bugs.sugarlabs.org/ Sugar Labs bug tracker] and
+assign them to component "Dextrose". You can use this component when you're in doubt, the maintainers
+will reassign it to the correct component.
+Before you file a new bug, please check the [http://bugs.sugarlabs.org/wiki/Dextrose Summary of all bugs affecting Dextrose]
+to avoid duplicates. You can comment on existing bugs to provide additional details.
-== Customizing the build ==
+=== Test plans ===
-The topic of  is too vast to discuss in detail here. Start by reading http://git.paraguayeduca.org/gitweb/users/bernie/olpc-os-builder.git/blob_plain/HEAD:/doc/README README] in the olpc-os-builder tree. Then, as needed, read the various <tt>README</tt>
+We currently don't have a formal test plan for Dextrose. We're looking for someone to
-files contained in the [http://git.paraguayeduca.org/gitweb/users/bernie/olpc-os-builder.git/tree/HEAD:/modules modules] directory.
+help us coordinate our QA effort. These are some useful starting points:
-Being a Build Master involves knowledge of many workflows, including:
+* [http://wiki.sugarlabs.org/go/Talk:Features/Soas_V4/ASLOxo_Activity_Test_Table SoaS V4 Activity Test Table] (2010)
+* [http://wiki.paraguayeduca.org/index.php/Test-plan_0.88 0.88 test plan from Paraguay Educa] (incomplete, 2010)
-* Building Sugar in [http://wiki.sugarlabs.org/go/Development_Team/Jhbuild sugar-jhbuild].
+* OLPC 8.2.0 (aka os801): [http://wiki.laptop.org/go/Test_cases_8.2.0 Test Cases], [http://wiki.laptop.org/go/TestResults_8.2.0 Test Results] (obsolete, 2008)
+* [http://wiki.laptop.org/go/Testing_matrix OLPC testing matrix] (obsolete, 2007)
-* Dealing with yum and [http://www.rpm.org/wiki/Docs rpm].
-* Understanding the [http://fedoraproject.org/wiki/Packaging/Guidelines Fedora packaging] workflow and conventions.
-* Creating yum package repositories with <tt>[http://createrepo.baseurl.org/]</tt>.
-* Uploading activities to [http://activities.sugarlabs.org].
-* General understanding of the Linux system plumbing infrastructure: [http://www.kernel.org/ kernel],
-[http://www.kernel.org/pub/linux/utils/kernel/hotplug/udev.html udev], [http://www.freedesktop.org/wiki/Software/dbus dbus], [http://www.freedesktop.org/wiki/Software/DeviceKit DeviceKit], [http://www.freedesktop.org/wiki/NetworkManager NetworkManager],
-[http://www.x.org/wiki/ Xorg]...
-* Flashing laptops and debugging any problems
-* Interaction with the Sugar and OLPC community to solve issues and minimize our divergence from the official builds.
-== Upstream ==
-Our upstream code comes from dev.laptop.org:
- git remote add olpc git://dev.laptop.org/projects/olpc-os-builder
- git fetch olpc
- git log olpc/master
-== Building custom kernels ==
- $ git clone git://git.paraguayeduca.org/users/bernie/olpc-2.6
- $ cd olpc-2.6
- $ setarch i386 make ARCH=i386 xo_1-kernel-rpm
-[[Category:SIG]]