conda-forge / conda-forge.github.io

The conda-forge website.
https://conda-forge.org
BSD 3-Clause "New" or "Revised" License
127 stars 274 forks source link

Basic terminologies for beginners #1428

Open hitblunders opened 3 years ago

hitblunders commented 3 years ago

When a beginner goes through the documentation, it may be quite overwhelming for him/her and he/she may feel lost. Is it a good idea to add definition for some basic terminologies like recipe(@Aaishpra already worked on it), feedstock etc. somewhere(may be in the glossary)?

viniciusdc commented 3 years ago

Hi @hitblunders I am almost sure that we already have those definitions inside our docs (we might need to search though). But I agreed that a more outstanding place should clarify some beginner's thoughts about those terms... If you can't find then look in the CFEP's their definitions should be there. About the glossary idea, IDK, cause if you follow the submit a package guide to conda-forge you will encounter the def's of most of these terms.

hitblunders commented 3 years ago

Hi @hitblunders I am almost sure that we already have those definitions inside our docs (we might need to search though). But I agreed that a more outstanding place should clarify some beginner's thoughts about those terms... If you can't find then look in the CFEP's their definitions should be there. About the glossary idea, IDK, cause if you follow the submit a package guide to conda-forge you will encounter the def's of most of these terms.

Thank you for responding @viniciusdc. Yes, I saw that definitions of most of the terms are there in the website somewhere. All I was saying is can we keep them in a separate place so that it's more easy for an absolute beginner to get complete clarity of thought?

Trend20 commented 3 years ago

Hi @hitblunders, thank you for coming up with this question. It is true that sometimes as a beginner you may get lost in the docs and become overwhelmed with the terms hence giving up on learning. I think finding a better way of structuring the terms before proceeding to the actual content is very necessary.

Azmeerabhagyasree commented 2 years ago

can i work on this

vanshmehra commented 2 years ago

Hey can I work on this? I am an outreach applicant