Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

More explanation for links #30

Open
brson opened this issue Jan 14, 2016 · 2 comments
Open

More explanation for links #30

brson opened this issue Jan 14, 2016 · 2 comments

Comments

@brson
Copy link
Contributor

brson commented Jan 14, 2016

Right now it's just a collection of links (the basic format of each entry is 'name - author'). It might be helpful to make room for 1-2 sentence explanations of the link, particularly as the list grows.

(PS this project is linked prominently from the website now)

@ctjhoa
Copy link
Owner

ctjhoa commented Jan 15, 2016

Thank you very much for the link @brson ! It's very valuable for my small project.

For this issue, I'm not against adding some explanations on links, but there is some issues.

First, most of links doesn't have this short description so I have to write it myself and some author may not like it (I've already faced issue for a wrong title. See #15 ). Plus, as English is not my mother tongue, I'm not sure to be able to write the perfect description on each link.

Second, as you mentioned it "the list grow". If I add a description on each link, a single file won't be sufficient anymore and I will need to split each section in separate file. Looking for a specific subject might also be more difficult because file will be less readable.

Finally I'm not sure that explanations will be so helpful since we already got the title of the article and the section's name to determine the subject.

Tell me what you think. If anyone wants to share his thoughts on this issue I take it.

@Ethkuil
Copy link

Ethkuil commented Apr 19, 2023

There are many materials and which ones are "better" usually depends on the reader themself.

For example, I have learned C++ (so some introduction can be simplified and comparison with C++ is welcomed), I prefer there is a small project with most important basic features of Rust but except that I I prefer learning from definitions instead of by examples.

However, certainly there are learners with different knowledge basis and different prefers.

It would be much more perfect if these info, the style of the materials, could be added. Even if not all materials are covered. What's more, readers can new a PR to describe some material after they have experienced it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

3 participants