mojodojodev / mojodojo.dev

Learning materials for the Mojo🔥programming language
https://mojodojo.dev/
88 stars 16 forks source link

[Content] Introduction material for concepts like coroutines, parallelization, vectors etc. #38

Open Brian-M-J opened 1 year ago

Brian-M-J commented 1 year ago

Currently, the Mojo documentation assumes that the reader is already familiar with system programming concepts. This makes it harder for new and new-ish programmers to understand how to use the low-level features that Mojo provides. I suggest a few articles explaining how the specific feature works, how to use it and a few examples of use cases.

A list of features I have in mind is as follows:

This is not a comprehensive list and there may be other things that programmers struggle to understand.

mojodojodev commented 1 year ago

Great ideas, thanks very much for raising the things that aren't clear, that is a really good list of next things to tackle and I'll prioritize them

Lorenzobattistela commented 1 year ago

@mojodojodev i'm thinking about starting to write about SIMD, what format do you think it'll be appropriate? Guide section, article...? I think an article would fit this purpose.

Brian-M-J commented 1 year ago

I agree. I think articles should be preferred in general for now as Mojo is still in a very early stage. I think the focus should be on making readers understand the underlying concept rather than its specific implementation in Mojo, as not only can that change, but the team might add a high level abstraction that makes it unnecessary to explain the exact details of how the feature works to beginners.

Lorenzobattistela commented 1 year ago

Will start writing up some content on SIMD

mojodojodev commented 1 year ago

Will start writing up some content on SIMD

Sounds great thanks, yeah I think tutorial style introduction will be really good, there's a heap of dunder methods which we can build out over time