diff mbox series

[33/53] README: remove obsolete poky repo references

Message ID 20251224-remove-poky-references-v1-33-658a5f4dbde2@bootlin.com
State Superseded
Headers show
Series Remove obsolete poky repo references | expand

Commit Message

Antonin Godard Dec. 24, 2025, 4:31 p.m. UTC
Refresh the document now that the Poky repository is obsolete.

Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
---
 documentation/README | 39 ++++++++++-----------------------------
 1 file changed, 10 insertions(+), 29 deletions(-)

Comments

Quentin Schulz Jan. 13, 2026, 2:44 p.m. UTC | #1
Hi Antonin,

On 12/24/25 5:31 PM, Antonin Godard via lists.yoctoproject.org wrote:
> Refresh the document now that the Poky repository is obsolete.
> 
> Signed-off-by: Antonin Godard <antonin.godard@bootlin.com>
> ---
>   documentation/README | 39 ++++++++++-----------------------------
>   1 file changed, 10 insertions(+), 29 deletions(-)
> 
> diff --git a/documentation/README b/documentation/README
> index 56eac7ca1..58b00ff5c 100644
> --- a/documentation/README
> +++ b/documentation/README
> @@ -1,33 +1,14 @@
>   documentation
>   =============
>   
> -This is the directory that contains the Yocto Project documentation.  The Yocto
> -Project source repositories at https://git.yoctoproject.org/cgit.cgi have two
> -instances of the "documentation" directory.  You should understand each of
> -these instances.
> -
> -  poky/documentation - The directory within the poky Git repository containing
> -                       the set of Yocto Project manuals.  When you clone the
> -                       poky Git repository, the documentation directory
> -                       contains the manuals.  The state of the manuals in this
> -                       directory is guaranteed to reflect the latest Yocto
> -                       Project release.  The manuals at the tip of this
> -                       directory will also likely contain most manual
> -                       development changes.
> -
> -  yocto-docs/documentation - The Git repository for the Yocto Project manuals.
> -                             This repository is where manual development
> -                             occurs.  If you plan on contributing back to the
> -                             Yocto Project documentation, you should set up
> -                             a local Git repository based on this upstream
> -                             repository as follows:
> -
> -                               git clone git://git.yoctoproject.org/yocto-docs
> -
> -                             Changes and patches are first pushed to the
> -                             yocto-docs Git repository.  Later, they make it
> -                             into the poky Git repository found at
> -                             git://git.yoctoproject.org/poky.
> +This is the directory that contains the Yocto Project documentation. The Yocto
> +Project documentation is hosted at https://git.yoctoproject.org/yocto-docs:
> +
> +This repository is where manual development occurs. If you plan on contributing
> +back to the Yocto Project documentation, you should set up a local Git
> +repository based on this upstream repository as follows:
> +
> +  git clone git://git.yoctoproject.org/yocto-docs
>   
>   Manual Organization
>   ===================
> @@ -261,9 +242,9 @@ For example, the following .rst content will produce the 'expected'
>   content:
>   
>     .. code-block::
> -      $ mkdir poky-&DISTRO;
> +      $ mkdir project-&DISTRO;
>         or
> -      $ git clone &YOCTO_GIT_URL;/git/poky -b &DISTRO_NAME_NO_CAP;
> +      $ git clone &YOCTO_GIT_URL;/git/yocto-docs -b &DISTRO_NAME_NO_CAP;

YOCTO_GIT_URL doesn't exist anymore, please send a follow-up patch to 
fix that oversight.

Same for the nested variable, but you can replace with 
YOCTO_RELEASE_DL_URL and YOCTO_DL_URL for example.

These are unrelated to the patch, so

Reviewed-by: Quentin Schulz <quentin.schulz@cherry.de>

Thanks!
Quentin
diff mbox series

Patch

diff --git a/documentation/README b/documentation/README
index 56eac7ca1..58b00ff5c 100644
--- a/documentation/README
+++ b/documentation/README
@@ -1,33 +1,14 @@ 
 documentation
 =============
 
-This is the directory that contains the Yocto Project documentation.  The Yocto
-Project source repositories at https://git.yoctoproject.org/cgit.cgi have two
-instances of the "documentation" directory.  You should understand each of
-these instances.
-
-  poky/documentation - The directory within the poky Git repository containing
-                       the set of Yocto Project manuals.  When you clone the
-                       poky Git repository, the documentation directory
-                       contains the manuals.  The state of the manuals in this
-                       directory is guaranteed to reflect the latest Yocto
-                       Project release.  The manuals at the tip of this
-                       directory will also likely contain most manual
-                       development changes.
-
-  yocto-docs/documentation - The Git repository for the Yocto Project manuals.
-                             This repository is where manual development
-                             occurs.  If you plan on contributing back to the
-                             Yocto Project documentation, you should set up
-                             a local Git repository based on this upstream
-                             repository as follows:
-
-                               git clone git://git.yoctoproject.org/yocto-docs
-
-                             Changes and patches are first pushed to the
-                             yocto-docs Git repository.  Later, they make it
-                             into the poky Git repository found at
-                             git://git.yoctoproject.org/poky.
+This is the directory that contains the Yocto Project documentation. The Yocto
+Project documentation is hosted at https://git.yoctoproject.org/yocto-docs:
+
+This repository is where manual development occurs. If you plan on contributing
+back to the Yocto Project documentation, you should set up a local Git
+repository based on this upstream repository as follows:
+
+  git clone git://git.yoctoproject.org/yocto-docs
 
 Manual Organization
 ===================
@@ -261,9 +242,9 @@  For example, the following .rst content will produce the 'expected'
 content:
 
   .. code-block::
-      $ mkdir poky-&DISTRO;
+      $ mkdir project-&DISTRO;
       or
-      $ git clone &YOCTO_GIT_URL;/git/poky -b &DISTRO_NAME_NO_CAP;
+      $ git clone &YOCTO_GIT_URL;/git/yocto-docs -b &DISTRO_NAME_NO_CAP;
 
 Variables can be nested, like it was the case for DocBook: