linux/poky.git/documentation/contributor-guide, branch styhead

contributor-guide/submit-changes: add policy on AI generated code

2025-02-21T14:34:58+00:00

Based on message by Richard Purdie on the yocto-docs list: https://lists.yoctoproject.org/g/docs/message/6300 Re-formatted for the Yocto Project documentation syntax. (From yocto-docs rev: 843078e4bd97a5bedf121e0e0105fd20162a25d8) Signed-off-by: Antonin Godard (cherry picked from commit a72dd13e6841b621c9e8f904dfaa440c186d2959) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman

contributor-guide/submit-changes.rst: suggest to remove the git signature

2025-01-09T14:02:49+00:00

By default when sending patches Git adds the git version at the bottom of the patch, which is not necessary in most cases. Suggest to remove it when configuring Git when sending patches. Suggested-By: Jaekyu Lee (From yocto-docs rev: 8ce5875766008827de7bc9bcf8ee5417d557abcb) Signed-off-by: Antonin Godard (cherry picked from commit d3465691231f10466703198a831a681803ffdfad) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman

Update the documentation for SRCPV

2024-12-26T14:01:37+00:00

The variable SRCPV is deprecated since 4.3. Instead of including SRCPV in PV, including the sign "+" is enough for bitbake to add the source control information to PKGV during the packaging phase. Update the documentation for SRCPV and the places where it was used. When instructions previously referred to SRCPV, replace by mentioning to include "+" in the assignment. In most examples, "+git" is added to PV as it is the most popular SCM. Simply adding "+" is also possible, although it is better practice to include the SCM name, so give that example. Update the gcompat example with l3afpad as it didn't include "+git" in its PV definition anymore. (From yocto-docs rev: 3866c09cc0460d25fefc0c831affd89633cf8a7b) Signed-off-by: Antonin Godard (cherry picked from commit ee16c96202e5027d1a8d7e89e11c25f127c78326) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman

contributor-guide: Remove duplicated words

2024-11-26T13:37:10+00:00

Remove "and then" as it is duplicated. (From yocto-docs rev: 6bab46640d63949034eedc52c6c367198c9e91c5) Signed-off-by: Talel BELHAJSALEM Reviewed-by: Quentin Schulz Signed-off-by: Antonin Godard (cherry picked from commit 52ed947120e400620277a58f895294b558a9324e) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman

conf.py: rename :cve: role to :cve_nist:

2024-11-11T17:16:26+00:00

Newer versions of Sphinx already define a :cve: role that points to cve.org, instead of the role we defined in conf.py that points to nvd.nist.gov. Rename our role to :cve_nist: to avoid warnings (treated as errors). This is also backwards compatible, meaning we can build the doc with an older Sphinx if needed. The file were automatically replaced with following command: find . -name '*.rst' -exec sed -i 's/:cve:/:cve_nist:/g' {} \+ Suggested-By: Quentin Schulz Reviewed-by: Quentin Schulz (From yocto-docs rev: 1e5e574a6cdb6b086da2c5a981446b522e80cf2d) Signed-off-by: Antonin Godard (cherry picked from commit 15fa3b7e85dde50d7236c1738ad607531cc654b8) Signed-off-by: Antonin Godard Signed-off-by: Steve Sakoman

recipe style guide: add recommendation for patches without signature

2024-06-16T21:48:18+00:00

>From discussion [0], the presence of git version signature at the end of patches has been questionned. To avoid a bit more noise, the setting git format.signature is added to the documentation and its use is recommended. [0]: https://lists.openembedded.org/g/openembedded-core/topic/106323318#msg199967 (From yocto-docs rev: 7da39b91a0f20cb7215d51e00c098f3dc13180fd) Signed-off-by: Alexandre Truong Reviewed-by: Yoann Congal Reviewed-by: Michael Opdenacker Signed-off-by: Alexandre Belloni Signed-off-by: Richard Purdie

manuals: refer to new yocto-patches mailing list wherever appropriate

2024-04-08T13:36:38+00:00

There's a new yocto-patches mailing list available for all layers that do not have their own mailing list. c.f. https://lists.yoctoproject.org/g/yocto/topic/105197684 Cc: Quentin Schulz (From yocto-docs rev: ac512f76b93a20507a6835ddafa954b4ae45e268) Signed-off-by: Quentin Schulz Reviewed-by: Michael Opdenacker Signed-off-by: Richard Purdie

contributor-guide: be more specific about meta-* trees

2024-03-19T15:22:27+00:00

* this is often confused to apply for e.g. meta-oe as well where it doesn't apply as meta-oe has own ML mentioned in README. (From yocto-docs rev: 63be0814a7ecf38c570b6d776f62b7c7803eb299) Signed-off-by: Martin Jansa Reviewed-by: Michael Opdenacker Signed-off-by: Richard Purdie

contributor-guide: add notes for tests

2024-03-06T16:54:54+00:00

This adds some hints that and how changes should be tested when contributing. Fixes [YOCTO #15412] (From yocto-docs rev: 6f3dbb2a909ba5b71efb09b251ee3f8650e30146) Signed-off-by: Simone Weiß Reviewed-by: Michael Opdenacker Signed-off-by: Richard Purdie

contributor-guide: fix lore URL

2024-02-05T14:30:34+00:00

Cc: Michael Opdenacker (From yocto-docs rev: 5962a09a120681c1328e05335c2f14fad06c63ce) Signed-off-by: Baruch Siach Reviewed-by: Michael Opdenacker Signed-off-by: Richard Purdie