[Proposition] Workshop-like documentation

[Proposition] Workshop-like documentation

[Talel BELHADJ SALEM]

[-- Attachment #1: Type: text/plain, Size: 662 bytes --]

Hello Michael,

I have a website for Yocto that I have some articles in there:
https://yoctoleef.xyz/

I am a Yocto trainer for long time now, and I love detailing everything,

For instance check:
https://yoctoleef.xyz/2023/07/27/details-you-should-know-about-the-recipes-working-directory-part-ii/

I would like to contribute something like:

   - Practical Manual, or
   - Workshop Manual

or something like that, the aim is to provide a learning process for
newcomers.

It is like putting a Yocto training path with workshops and examples to
follow in order to master Yocto.

It is like The Rust Programming Book idea.

What do you think?

Kind regards
Talel

[-- Attachment #2: Type: text/html, Size: 1079 bytes --]

Re: [docs] [Proposition] Workshop-like documentation

[Alexander Kanavin]

Hello Talel,

I really like the idea. Hand drawn diagrams are awesome! This could be
on the doc website just under the 'Quick Build':
https://docs.yoctoproject.org/index.html

Alex

On Fri, 20 Oct 2023 at 19:06, BELHADJ SALEM Talel <bhstalel@gmail.com> wrote:
>
> Hello Michael,
>
> I have a website for Yocto that I have some articles in there: https://yoctoleef.xyz/
>
> I am a Yocto trainer for long time now, and I love detailing everything,
>
> For instance check: https://yoctoleef.xyz/2023/07/27/details-you-should-know-about-the-recipes-working-directory-part-ii/
>
> I would like to contribute something like:
>
> Practical Manual, or
> Workshop Manual
>
> or something like that, the aim is to provide a learning process for newcomers.
>
> It is like putting a Yocto training path with workshops and examples to follow in order to master Yocto.
>
> It is like The Rust Programming Book idea.
>
> What do you think?
>
> Kind regards
> Talel
>
> -=-=-=-=-=-=-=-=-=-=-=-
> Links: You receive all messages sent to this group.
> View/Reply Online (#4450): https://lists.yoctoproject.org/g/docs/message/4450
> Mute This Topic: https://lists.yoctoproject.org/mt/102085617/1686489
> Group Owner: docs+owner@lists.yoctoproject.org
> Unsubscribe: https://lists.yoctoproject.org/g/docs/unsub [alex.kanavin@gmail.com]
> -=-=-=-=-=-=-=-=-=-=-=-
>

Re: [docs] [Proposition] Workshop-like documentation

[Talel BELHADJ SALEM]

[-- Attachment #1: Type: text/plain, Size: 1864 bytes --]

Hello Alexander,

Thanks for the suggestion.

I have the article "Things you should know about Recipe's working directory"

I think it can be added to "dev-manual" as "40. Understanding WORKDIR" or
"40. Recipe WORKDIR workshop"

What do you think?

Kind regards
Talel

On Mon, Oct 23, 2023 at 12:30 PM Alexander Kanavin <alex.kanavin@gmail.com>
wrote:

> Hello Talel,
>
> I really like the idea. Hand drawn diagrams are awesome! This could be
> on the doc website just under the 'Quick Build':
> https://docs.yoctoproject.org/index.html
>
> Alex
>
> On Fri, 20 Oct 2023 at 19:06, BELHADJ SALEM Talel <bhstalel@gmail.com>
> wrote:
> >
> > Hello Michael,
> >
> > I have a website for Yocto that I have some articles in there:
> https://yoctoleef.xyz/
> >
> > I am a Yocto trainer for long time now, and I love detailing everything,
> >
> > For instance check:
> https://yoctoleef.xyz/2023/07/27/details-you-should-know-about-the-recipes-working-directory-part-ii/
> >
> > I would like to contribute something like:
> >
> > Practical Manual, or
> > Workshop Manual
> >
> > or something like that, the aim is to provide a learning process for
> newcomers.
> >
> > It is like putting a Yocto training path with workshops and examples to
> follow in order to master Yocto.
> >
> > It is like The Rust Programming Book idea.
> >
> > What do you think?
> >
> > Kind regards
> > Talel
> >
> > -=-=-=-=-=-=-=-=-=-=-=-
> > Links: You receive all messages sent to this group.
> > View/Reply Online (#4450):
> https://lists.yoctoproject.org/g/docs/message/4450
> > Mute This Topic: https://lists.yoctoproject.org/mt/102085617/1686489
> > Group Owner: docs+owner@lists.yoctoproject.org
> > Unsubscribe: https://lists.yoctoproject.org/g/docs/unsub [
> alex.kanavin@gmail.com]
> > -=-=-=-=-=-=-=-=-=-=-=-
> >
>

[-- Attachment #2: Type: text/html, Size: 3264 bytes --]

Re: [docs] [Proposition] Workshop-like documentation

[Michael Opdenacker]

Hi Talel

On 23.10.23 at 17:53, BELHADJ SALEM Talel wrote:
> Hello Alexander,
>
> Thanks for the suggestion.
>
> I have the article "Things you should know about Recipe's working 
> directory"
>
> I think it can be added to "dev-manual" as "40. Understanding WORKDIR" 
> or "40. Recipe WORKDIR workshop"
>
> What do you think?


This sounds like a great idea indeed!
Or maybe as an improvement to 
https://docs.yoctoproject.org/overview-manual/concepts.html.

I let you check what could be the best place.

If we are talking about tutorials, we could add a new "Tutorials" manual 
with various documents underneath. I already have a kernel lab from Tim 
Orling to include too as soon as I have time.

Thanks again
Cheers
Michael.

-- 
Michael Opdenacker, Bootlin
Embedded Linux and Kernel engineering
https://bootlin.com