diff --git a/documentation/dev-manual/dev-manual-newbie.xml b/documentation/dev-manual/dev-manual-newbie.xml
index abf0890d65..4d99e39530 100644
--- a/documentation/dev-manual/dev-manual-newbie.xml
+++ b/documentation/dev-manual/dev-manual-newbie.xml
@@ -79,8 +79,8 @@
Systems across a large team should meet the needs of
- two types of developers: those working on the direction of the
- software stack itself and those developing applications.
+ two types of developers: those working on the contents of the
+ operating system image itself and those developing applications.
Regardless of the type of developer, their workstations must
be both reasonably powerful and run Linux.
@@ -131,8 +131,11 @@
build system itself available on the developer workstations
so developers can run their own builds and directly
rebuild the software stack.
- You should keep the core system standard as much as
+ You should keep the core system unchanged as much as
possible and do your work in layers on top of the core system.
+ Doing so gives you a greater level of portability when
+ upgrading to new versions of the core system or Board
+ Support Packages (BSPs).
You can share layers amongst the developers of a particular
project and contain the policy configuration that defines
the project.
@@ -357,14 +360,17 @@
Git repositories.
Set up the directory for the shared state cache
(SSTATE_DIR)
- where they make sense.
- For example, set up the sstate cache for developers using the
- same office and share source directories on the developer's
- machines.
+ where it makes sense.
+ For example, set up the sstate cache on a system used
+ by developers that share the same office and share the
+ same source directories on their machines.
+
Set up an autobuilder and have it populate the
sstate cache and source directories.
- Follow the project commit guidelines for
- writing good commit messages.
+ The Yocto Project community encourages you
+ to send patches to the project to fix bugs or add features.
+ If you do submit patches, follow the project commit
+ guidelines for writing good commit messages.
See the "How to Submit a Change"
section.Send changes to the core sooner than later