Brief Introduction page of conda-forge( Reference: issue #374 )

[prachinandi]

I took the reference from the issue #374 I would like make changes in the brief introduction page of conda-forge documentation.
would like to re-structure the page and give a precise and brief intro of conda-forge. we can define that as mentioned in https://anaconda.org/conda-forge i.e "A community-led collection of recipes, build infrastructure, and distributions for the conda package manager."

The two questions that are mentioned in the What is conda-forge introduction, instead of answering these two questions in what is conda-forge, they can be shown in FAQ section (in-fact one of the question is already present in FAQ section.

[benny-coy]

Outreachy applicant 2021

Please can i work on this issue?
pls assign me.

[prachinandi]

Outreachy applicant 2021

Please can i work on this issue?
pls assign me.

I m working on it 😄

[prachinandi]

Outreachy applicant 2021

Please can i work on this issue?
pls assign me.

since, even u r an outreachy applicant I would suggest u to go thru the issues that r labeled with docs.

[PrernaSingh587]

I think we should not entirely remove this section from the intro. It forms the basis. FAQ is for more of technical (and profound) questions. Introduction should definitely have this part. Just my perspective. :)
What do you think @viniciusdc ?

[prachinandi]

I think we should not entirely remove this section from the intro. It forms the basis. FAQ is for more of technical (and profound) questions. Introduction should definitely have this part. Just my perspective. :)
What do you think @viniciusdc ?

What I think, someone who is new to the org, won't be installing the packages or contribute in the first sight. He/she will first flick through the documentation first, and that is the main purpose of having a documentation for an organization. Hence according tto me we shd keep the intro brief and those questions can be added in the relevent sections, infact we have a complete separate section for that, reading those will make every thing clear for a new user.

[prachinandi]

In addition in the issue #374 @ocefpaf had defined conda-forge really well, as someone new to org can easily understand it's purpose😅😄

[PrernaSingh587]

I think we should not entirely remove this section from the intro. It forms the basis. FAQ is for more of technical (and profound) questions. Introduction should definitely have this part. Just my perspective. :)
What do you think @viniciusdc ?

What I think, someone who is new to the org, won't be installing the packages or contribute in the first sight. He/she will first flick through the documentation first, and that is the main purpose of having a documentation for an organization. Hence according tto me we shd keep the intro brief and those questions can be added in the relevent sections, infact we have a complete separate section for that, reading those will make every thing clear for a new user.

But we also have to make it look appealing to them. If there is not a proper introduction, that might be a turn off. When we read something or start to watch something, the intro is what makes the first impression on us. We can't remove the What and Why conda-forge section for sure, that would not be good according to me. And @viniciusdc could better answer if we require a separate section for anything. Though I would still agree with you that the intro has to be re-modified any how. :)

[PrernaSingh587]

In addition in the issue #374 @ocefpaf had defined conda-forge really well, as someone new to org can easily understand it's purposesweat_smilesmile

I think we can take insights from it and come up with something good to redefine the intro. What do you say?

[prachinandi]

I think we should not entirely remove this section from the intro. It forms the basis. FAQ is for more of technical (and profound) questions. Introduction should definitely have this part. Just my perspective. :)
What do you think @viniciusdc ?

What I think, someone who is new to the org, won't be installing the packages or contribute in the first sight. He/she will first flick through the documentation first, and that is the main purpose of having a documentation for an organization. Hence according tto me we shd keep the intro brief and those questions can be added in the relevent sections, infact we have a complete separate section for that, reading those will make every thing clear for a new user.

But we also have to make it look appealing to them. If there is not a proper introduction, that might be a turn off. When we read something or start to watch something, the intro is what makes the first impression on us. We can't remove the What and Why conda-forge section for sure, that would not be good according to me. And @viniciusdc could better answer if we require a separate section for anything. Though I would still agree with you that the intro has to be re-modified any how. :)

aee no I am not asking to remove those two sections, I only had suggested to improve "what is conda-forge" definition

[prachinandi]

In addition in the issue #374 @ocefpaf had defined conda-forge really well, as someone new to org can easily understand it's purposesweat_smilesmile

I think we can take insights from it and come up with something good to redefine the intro. What do you say?

That's what I suggested 😅😄

[viniciusdc]

great! @prachi237 and @PrernaSingh587 thanks for the discussion there, any new insights on this?

[viniciusdc]

BTW, isn't this issue a duplicate of #1282 ?

[prachinandi]

BTW, isn't this issue a duplicate of #1282 ?

sir I just proposed to look into issue #374 where @ocefpaf had defined conda-forge really well, so if I can add that definition.
if approved I can send PR right now have done the editing in my system.

[viniciusdc]

yes, go ahead! 😄 every PR is welcomed

[PrernaSingh587]

I have raised a PR for this. #1325
@prachi237 You might wanna add to it. Suggestions are welcome.

[viniciusdc]

HI @prachi237 @PrernaSingh587 would you mind closing this issue and post a brief comment in the #1282 and link your PR there too, this will help us to not lose track of things. It can be the exact same content of this issue