Development Manual Rework: Difference between revisions

From Yocto Project
Jump to navigationJump to search
No edit summary
No edit summary
Line 25: Line 25:
   c) How to help them choose the right kernel
   c) How to help them choose the right kernel
   d) etc.
   d) etc.
= Notes for Chapter 4 of the dev-manual: =
== Section 4.1 - "System Development Workflow" ==
Introductory material that will follow the subsections.  Standard stuff to be adjusted depending on where it lands in the YP doc set.
== Section 4.1.1 - "Developing a Board Support Package (BSP)" ==
Although the steps in this section are technically procedural, the level is more conceptual.  We should move this discussion to the ref-manual and group it under some sort of new "concepts" heading where conceptual information is discussed.  That is one idea.  Another, is to create a conceptual section in the BSP Guide to hold this information.  One thing we have not discussed is the fate of the BSP Guide in regards to the restructuring of the dev-manual to a task-based document.  In any case, the current "Developing a Board Support Package (BSP)" section in the dev-manual is out.  If we want to replace it in the dev-manual with something more concrete, then I suggest a real example that would be in the form of what is on this dated wiki page - https://wiki.yoctoproject.org/wiki/Transcript:_creating_one_generic_Atom_BSP_from_another.
== Section 4.1.2 - "Modifying the Kernel" ==
The information in this section is very conceptual and does not belong in the dev-manual.  Solution for this section is similar to what I suggested for the "Developing a Board Support Package (BSP)" section above.  However, this is kernel related so perhaps moving this kernel information to the kernel-dev manual.  Again, if we want to have some concrete example in the dev-manual that is based on the conceptual information here, then we create a real example and use that and tie it to specific tasks.

Revision as of 17:23, 8 June 2017

This page will propose an outline for Development Manual refactoring work. See also bug #11630

The way Henry described this yesterday, customers use the "getting started" guide to learn how to bring up a vanilla image, but then don't know how to approach their own custom situation. This should be a TRANSITION DOCUMENT - how to use YP once you have gotten your feet wet in a controlled situation. Feel free to delete this, I don't know how you folks work in the WIKI and I'm assuming this may not be it.

I would suggest organizing this in a couple of ways - and this might be better in a google doc, frankly. 1) by what people need to do to get started

  a) where to start to support a platform
     1. find a BSP and test it
  b) how to add support for platform components
  c) how to slim down an image size
     1. Remove code automatically included
     2. design your own BSP fine tuned to exclude extra code, unneeded support code
  d) How to approach setting up a development environment
  e) How use layers to create a flexible long term design, and recipes
  d) How do you start a new project vs build off an existing one   
  e) How do you set up a team sharable development environment (sstate)
  f) Here are some of the most common commands 
  g) How to deal with CVEs and code branches

2) By helping them collect the information they need in order to make set up decisions Brent had a great idea to make this a SW Wizard that would step a new user through a series of questions and give them at least one solution on how to proceed.

  a) what platform are you using
  b) will you include an application as part of the image or will it run on the image
  c) what is the configuration of the team (system developers, app developers, etc)
  c) How to help them choose the right kernel
  d) etc.


Notes for Chapter 4 of the dev-manual:

Section 4.1 - "System Development Workflow"

Introductory material that will follow the subsections. Standard stuff to be adjusted depending on where it lands in the YP doc set.

Section 4.1.1 - "Developing a Board Support Package (BSP)"

Although the steps in this section are technically procedural, the level is more conceptual. We should move this discussion to the ref-manual and group it under some sort of new "concepts" heading where conceptual information is discussed. That is one idea. Another, is to create a conceptual section in the BSP Guide to hold this information. One thing we have not discussed is the fate of the BSP Guide in regards to the restructuring of the dev-manual to a task-based document. In any case, the current "Developing a Board Support Package (BSP)" section in the dev-manual is out. If we want to replace it in the dev-manual with something more concrete, then I suggest a real example that would be in the form of what is on this dated wiki page - https://wiki.yoctoproject.org/wiki/Transcript:_creating_one_generic_Atom_BSP_from_another.

Section 4.1.2 - "Modifying the Kernel"

The information in this section is very conceptual and does not belong in the dev-manual. Solution for this section is similar to what I suggested for the "Developing a Board Support Package (BSP)" section above. However, this is kernel related so perhaps moving this kernel information to the kernel-dev manual. Again, if we want to have some concrete example in the dev-manual that is based on the conceptual information here, then we create a real example and use that and tie it to specific tasks.