<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://bugzilla.yoctoproject.org/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.6"
          urlbase="https://bugzilla.yoctoproject.org/"
          
          maintainer="it-coreprojects-helpdesk@linuxfoundation.org"
>

    <bug>
          <bug_id>6286</bug_id>
          
          <creation_ts>2014-05-07 22:21:31 +0000</creation_ts>
          <short_desc>Autobuilder developers manual</short_desc>
          <delta_ts>2015-11-17 16:01:46 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>5</classification_id>
          <classification>Infrastructure</classification>
          <product>AutoBuilder</product>
          <component>autobuilder</component>
          <version>unspecified</version>
          <rep_platform>x86</rep_platform>
          <op_sys>Multiple</op_sys>
          <bug_status>VERIFIED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>Medium</priority>
          <bug_severity>enhancement</bug_severity>
          <target_milestone>2.0</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Beth Flanagan">elizabeth.flanagan</reporter>
          <assigned_to name="Beth Flanagan">elizabeth.flanagan</assigned_to>
          <cc>bluelightning</cc>
    
    <cc>bogdanx.a.voiculescu</cc>
    
    <cc>elizabeth.flanagan</cc>
    
    <cc>infras.ab.watcher</cc>
    
    <cc>Infras.watcher</cc>
    
    <cc>jessica.zhang</cc>
          
          <qa_contact name="Bogdan Alexandru Voiculescu">bogdanx.a.voiculescu</qa_contact>
          <cf_os>---</cf_os>
          <cf_regression_type>---</cf_regression_type>
          
          <cf_docchange>Yes (doc changes required)</cf_docchange>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>43160</commentid>
    <comment_count>0</comment_count>
    <who name="Beth Flanagan">elizabeth.flanagan</who>
    <bug_when>2014-05-07 22:21:31 +0000</bug_when>
    <thetext>We need a developers manual that tells folks:

1. How to set up an autobuilder.
2. How to create their own configs
3. How to hack the autobuilder to create new buildsteps
4. How to contribute</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>43269</commentid>
    <comment_count>1</comment_count>
    <who name="Beth Flanagan">elizabeth.flanagan</who>
    <bug_when>2014-05-12 22:43:36 +0000</bug_when>
    <thetext>Lynn,

Work with me on this. As you&apos;ll have an outside view of what this takes, I think you&apos;d have a bit of a better view than I.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>43270</commentid>
    <comment_count>2</comment_count>
    <who name="Lynn Cyrin">lynncyrin</who>
    <bug_when>2014-05-12 22:53:01 +0000</bug_when>
    <thetext>Gotcha, creating guides / docs is one of my favorite tasks for new people.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>47113</commentid>
    <comment_count>3</comment_count>
    <who name="Beth Flanagan">elizabeth.flanagan</who>
    <bug_when>2014-11-20 16:13:55 +0000</bug_when>
    <thetext>We currently have this committed to the ab repo, still needs some additional info and a once over by srifenbark.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>47142</commentid>
    <comment_count>4</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2014-11-21 13:13:22 +0000</bug_when>
    <thetext>Beth, 

Can you tell me where to find this documentation?  I don&apos;t know how to get to the ab repo.  Once found, I will give it an edit.

Thanks, 
Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>47442</commentid>
    <comment_count>5</comment_count>
    <who name="Beth Flanagan">elizabeth.flanagan</who>
    <bug_when>2014-12-09 01:16:45 +0000</bug_when>
    <thetext>http://git.yoctoproject.org/cgit/cgit.cgi/yocto-autobuilder/tree/docs/YoctoAutobuilderDevelopersDocument.html

Scott,

if you could git clone the AB repo (git clone git://git.yoctoproject.org/yocto-autobuilder) and give this a quick read for clarity (it still is missing some stuff, but that&apos;s coming to a close), I&apos;d appreciate it.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>47455</commentid>
    <comment_count>6</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2014-12-09 12:54:07 +0000</bug_when>
    <thetext>Beth, 

So I cloned this and gave it a fast read.  Outside of some formatting and a few typo things it seems okay.  I do have some questions...

 1. Where is the source for this manual?  Is it simply a hand-created 
    HTML document?

 2. Do you want better formatting?  Or, is what we have adequate for the 
    particular audience?

 3. There are some missing items exposed through notes within the text.
    Are these going to be supplied later?

 4. How would one give feedback for the HTML document?  Is there a way 
    to submit a patch against the manual?

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>54822</commentid>
    <comment_count>7</comment_count>
    <who name="Beth Flanagan">elizabeth.flanagan</who>
    <bug_when>2015-09-30 13:17:16 +0000</bug_when>
    <thetext>I&apos;m going to mark this as Resolved. We have a slightly incomplete developers manual that exists and will need continued updating, but at this point, it makes no sense to have a continuous bug open for it.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>56546</commentid>
    <comment_count>8</comment_count>
    <who name="Bogdan Alexandru Voiculescu">bogdanx.a.voiculescu</who>
    <bug_when>2015-11-17 16:01:46 +0000</bug_when>
    <thetext>Document is created: 
http://git.yoctoproject.org/cgit/cgit.cgi/yocto-autobuilder/tree/docs/YoctoAutobuilderDevelopersDocument.html</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>