Writing the Contribute page

Question

Writing the Contribute page

KirstieJane opened this issue 9 years ago · 12 comments

We have a great guide for contributors but we need to transfer some of those details (probably not all) to the contribute page

One thing to note is that I'm not 100% sure that we want to call this a "Contribute" page. I think it might be mistaken as a page to add to the database! Maybe calling the page "Develop"??

Note that this issue is not the place to comment on formatting of the page. Go ahead and make a new issue for that if needed 😄

Answer 1 · 2016-06-06T11:55:29.000Z

Hi @KirstieJane ,

This is really awesome. Great work 👍 💯 . I would like to work on contribute page. Please let me know where to start first.

Thank you
Amit Kumar Jaiswal

Answer 2 · 2016-06-22T07:50:20.000Z

Hi @amitkumarj441 - the best place to start is our guide for contributors - take a look there and think about which pieces of information should be transferred to the website for people who come along and want to learn more about developing the project 😄

I won't be able to give feedback until July 1st, but feel free to give it a bash if you'd like!

Answer 3 · 2016-09-01T06:41:17.000Z

Can we explain how to contribute by using some graphical stuff or diagrams I think it will be more attractive rather than writing traditional doc.I know doc will be needed but we can try some other way that we can create interest for technical as well as non technical contributor for this.

Answer 4 · 2016-09-01T14:28:56.000Z

@drashti4 great thought 👍 ,

We need to design a title icon for the STEMMRoleModels. I think this would be a good start. What do you think?

Thanks!

Answer 5 · 2016-09-01T15:00:16.000Z

@raj-maurya cool.But have doubt is title icon is equal to logo of STEMM or something else?

Answer 6 · 2016-09-01T16:17:10.000Z

Hi @drashti4! Thank you for your suggestion! I like it - I think diagrams are way more friendly than text!

Do you want to put a sketch together to show what you're thinking of?

@raj-maurya - I think your suggestion of needing a smaller logo so we can use it as a title icon is great but not related to the documentation issue (unless I'm misunderstanding @drashti4's point).

(FYI the logos are in the SchematicDesign folder. But again, I don't think that's relevant for this issue.)

Answer 7 · 2016-09-01T16:55:43.000Z

@KirstieJane Yes you got my point. @raj-maurya join https://gitter.im/KirstieJane/STEMMRoleModels this room If you already there just send message in it about this idea.We can create some graphical tree or sort of classified pictures where It will show contribution area(Labels).

Answer 8 · 2016-09-01T18:03:20.000Z

Thanks @drashti4

Answer 9 · 2016-09-08T11:17:16.000Z

I have made this design for contribution page.Main reason is contributor should not have to open multiple tabs for opening each link and menu will also be less and concise so he/she can easily remember in which menu contributor was. It will be simillar to Rust documentation(https://doc.rust-lang.org/stable/book/getting-started.html) but we can create tree structure for main menu page like in thoughts or issue menu.

Answer 10 · 2016-10-09T10:50:21.000Z

Hi @drashti4 - thank you so much for putting these suggestions together.

I think this is aiming too high for the website as it stands at the moment. I'm very happy for you to continue to work on your plans if you feel strongly about them, but I think there are many other areas to focus on before we need to implement a contributing page that is this detailed.

Answer 11 · 2016-10-09T12:43:24.000Z

I just start contributing by seeing help wanted label.I am unaware of those areas.Can you tell me what are they?

Answer 12 · 2016-10-12T10:55:50.000Z

I'm going to close this issue as I don't think we need to have a separate contributing page on the website, we just need to make sure anyone who wants to join the developer team can find the CONTRIBUTING.md file in the repo.

Thanks everyone for all the great discussions.