Open Brian-M-J opened 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
@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.
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.
Will start writing up some content on SIMD
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
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.