| Summary: | Instructions to checkout a repository missing a cd | ||
|---|---|---|---|
| Product: | [Documentation] Quick Start | Reporter: | Chris Kottaridis <chriskot> |
| Component: | quick-start | Assignee: | Michael Halstead <mhalstead> |
| Status: | RESOLVED FIXED | QA Contact: | |
| Severity: | minor | ||
| Priority: | Medium+ | CC: | michael.opdenacker, poky.doc.watcher, poky.watcher, randy.macleod, ross.burton |
| Version: | unspecified | ||
| Target Milestone: | 4.1 M2 | ||
| Hardware: | x86 | ||
| OS: | Multiple | ||
| Whiteboard: | |||
| OS type for building Yocto: | --- | Type of Regression: | --- |
| Verified: | Documentation change: | Yes (doc changes required) | |
Hi Chris Thanks for reporting issues to us! Where are the instructions you are referring to? Are you talking about https://www.yoctoproject.org/software-overview/downloads/? I see no "git checkout" instructions. At least in the "Quick Build" document (https://docs.yoctoproject.org/brief-yoctoprojectqs/index.html), we tell people to run "cd" after cloning. Thanks in advance Michael. Hi again I really can't find the instructions missing a "cd" command. In particular, I see no such issue in the manuals. Would you mind pointing us directly at where this happens, please? Thanks in advance Michael. Chris? So the problem here is that if you google "yocto quick start", the top hit is https://www.yoctoproject.org/docs/2.4.2/yocto-project-qs/yocto-project-qs.html, which are obsolete docs from 2018. Michael: why is this URL not redirecting to docs.yoctoproject.org so we get the "this is obsolete!" header? Asked Michael H. to make https://www.yoctoproject.org/docs/2.4.2/yocto-project-qs/yocto-project-qs.html redirect to https://docs.yoctoproject.org as https://www.yoctoproject.org/docs/2.4.2/yocto-project-qs/ does. I've added a redirect specifically for the .html version to the docs site with the banner present. I've reenabled a pattern redirect for all of the www.yoctoproject.org/docs to docs.yoctoproject.org. There is a comment noting that the generic redirect caused problems in the past but I think we are ready to try again. I'm watching the logs for issues. Looks good to me. Thanks Michael! Closing this bug, as it is fixed in the new versions of the docs and the old docs are now clearly marked as obsolete. |
If you follow the instructions in the Yocto Project Release section you get an error when trying to perform the checkout: $ git clone git://git.yoctoproject.org/poky Cloning into 'poky'... remote: Enumerating objects: 561221, done. remote: Counting objects: 100% (1208/1208), done. remote: Compressing objects: 100% (774/774), done. remote: Total 561221 (delta 668), reused 674 (delta 416), pack-reused 560013 Receiving objects: 100% (561221/561221), 182.45 MiB | 3.27 MiB/s, done. Resolving deltas: 100% (407222/407222), done. Updating files: 100% (5252/5252), done. chris@creskotdev:~/tmp/yocto$ git checkout tags/yocto-2.4.2 -b poky_2.4.2 fatal: not a git repository (or any of the parent directories): .git The instructions need to add a cd to poky. They should look like this: $ git clone git://git.yoctoproject.org/poky Cloning into 'poky'... remote: Counting objects: 361782, done. remote: Compressing objects: 100% (87100/87100), done. remote: Total 361782 (delta 268619), reused 361439 (delta 268277) Receiving objects: 100% (361782/361782), 131.94 MiB | 6.88 MiB/s, done. Resolving deltas: 100% (268619/268619), done. Checking connectivity... done. $ cd poky $ git checkout tags/yocto-2.4.2 -b poky_2.4.2 This is a minor issue that most people could figure out. But the fix is easy and it saves an error popping up in the steps that will help build confidence in the instructions for a new user.