Dextrose/Getting Involved: Difference between revisions

Revision as of 14:58, 12 July 2012

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

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

Contents on this page will from now on be updated at the sugardextrose.org wiki, see https://sugardextrose.org/projects/dextrose/wiki/Testing_and_reporting_issues

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>
+<noinclude>
+{{TeamHeader|Dextrose|home=Dextrose|xbgColor=ffe792|join_label=Get Involved}}
-== F11-XO1 ==
+[[Category:Project]]
+[[Category:SIG]]
-We use [http://wiki.laptop.org/go/OS_Builder olpc-os-builder], a tool
+</noinclude>
-used by OLPC to create official and customized system images.
+{{Obsolete | Contents on this page will from now on be updated at the sugardextrose.org wiki, see https://sugardextrose.org/projects/dextrose/wiki/Testing_and_reporting_issues }}
-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/
- -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
-* Edit the paths in the <tt>[signing]</tt> section of <tt>examples/f11-xo1-py.ini</tt>
-== Publishing the images ==
-I'm currently publishing selected builds in [http://oficina.paraguayeduca.org/~bernie/f11-xo1-py/ my public html folder].
-Signed builds should be published only if they implement the OLPC anti-theft system
-([http://wiki.laptop.org/go/Antitheft_HowTo OATS]). Signing does
-not have anything to do with quality or endorsement (i.e. signed builds are not
-necessarily bug-free).
-* TODO: We don't have a place for publishing official images yet
-* TODO: We don't have a procedure for releasing builds to field technicians (we may use repo.paraguayeduca.org in the future)
-* TODO: We don't keep release notes for our builds (we should probably use the wiki)
-== Customizing the build ==
-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>
-files contained in the [http://git.paraguayeduca.org/gitweb/users/bernie/olpc-os-builder.git/tree/HEAD:/modules modules] directory.
-Being a Build Master involves knowledge of many workflows, including:
-* Building Sugar in [http://wiki.sugarlabs.org/go/Development_Team/Jhbuild sugar-jhbuild].
-* Dealing with yum and [http://www.rpm.org/wiki/Docs rpm].
+== Development ==
-* Understanding the [http://fedoraproject.org/wiki/Packaging/Guidelines Fedora packaging] workflow and conventions.
+If you want to create custom images, see the documentation of the [[Dextrose/Building|Dextrose build system]].
-* Creating yum package repositories with <tt>[http://createrepo.baseurl.org/]</tt>.
+== Testing ==
-* Uploading activities to [http://activities.sugarlabs.org].
+Feedback from the entire community is appreciated.
-* General understanding of the Linux system plumbing infrastructure: [http://www.kernel.org/ kernel],
+=== Reporting bugs upstream ===
-[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
+If you know the specific upstream project that contains the bug, please file your report into their bug tracker:
-* Interaction with the Sugar and OLPC community to solve issues and minimize our divergence from the official builds.
+* Sugar and activities: http://bugs.sugarlabs.org/
+* Drivers and OLPC customizations: http://dev.laptop.org/
+* Fedora OS: http://bugzilla.redhat.com/
-== Upstream ==
+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]].
-Our upstream code comes from dev.laptop.org:
+=== Reporting bugs specific to Dextrose ===
- git remote add olpc git://dev.laptop.org/projects/olpc-os-builder
+You can file bugs specific to Dextrose in the [http://bugs.sugarlabs.org/ Sugar Labs bug tracker] and
- git fetch olpc
+assign them to component "Dextrose". You can use this component when you're in doubt, the maintainers
- git log olpc/master
+will reassign it to the correct component.
-== Building custom kernels ==
+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.
- $ git clone git://git.paraguayeduca.org/users/bernie/olpc-2.6
+=== Test plans ===
- $ cd olpc-2.6
- $ setarch i386 make ARCH=i386 xo_1-kernel-rpm
+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:
-[[Category:SIG]]
+* [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)
+* 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)