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

Static Website explaining the project #19

Open
DhairyaBahl opened this issue Mar 2, 2022 · 14 comments
Open

Static Website explaining the project #19

DhairyaBahl opened this issue Mar 2, 2022 · 14 comments
Labels
discuss documentation Improvements or additions to documentation enhancement New feature or request good first issue Good for newcomers GSSoC22 This tag represents the issue or PR under the scope of Girls-script Summer of Codes' 22 Level3 Hard priority suggestions

Comments

@DhairyaBahl
Copy link
Member

Description

A static website explaining how to use this whiteboard and it should also have the section of guide to contribute and other important stuff like that. You can choose docusaurus or just gatsby itself and create a website. Jekyll will also work for this. Temporarily we can also manage with normal HTML CSS.

Contribution Tip

Due to the large size of this issue, contributors can make PRs and even create issues they are facing in this repo and each issue will be treated as Level3 because static website is on top priority.

Most importantly you should know the ins and outs of this project ! Then only you will be able to work on this issue. Since you will be explaining those ins and outs in the website itself.

Must include parts in website

  • Contributors Guide
  • How to build/run project in your local
  • Pre-requisites before starting contributing to this project.
@DhairyaBahl DhairyaBahl added documentation Improvements or additions to documentation enhancement New feature or request good first issue Good for newcomers GSSoC22 This tag represents the issue or PR under the scope of Girls-script Summer of Codes' 22 Level3 Hard discuss suggestions priority labels Mar 2, 2022
@DhairyaBahl
Copy link
Member Author

@vedant-jain03 I strongly suggest you to create another branch for this purpose ! Like DOCS-Main and choose the tech stack for that docs wisely as per the no. of contributors available for that.

@VaibhavUpreti
Copy link
Contributor

I think we should prefer NextJS as those are really easy to make with some basic tailwindCSS ,although making this would take a lot of time, I would like to work on this by posting my inputs and progress daily over here.

@DhairyaBahl
Copy link
Member Author

I think we should prefer NextJS as those are really easy to make with some basic tailwindCSS ,although making this would take a lot of time, I would like to work on this by posting my inputs and progress daily over here.

I think NextJS would be overkill for this type of task ! SSR is good but what is the benefit if we can simply create a static website. I get your point that rendering will be super fast but still I believe that static websites are perfect for docs and stuff like that.

@vedant-jain03 What do you say about NextJS for docs ?

@vedant-jain03
Copy link
Collaborator

vedant-jain03 commented Mar 2, 2022

@DhairyaBahl What I feel is NextJS will be really overwhelming for the project. So we should be in the scope of React only.
I have an idea ,

  • We can make project multisite with navbar having the option
    • Home (Landing page, Mission, Open source programs, footer)
    • About Us (Description, Contributors)
    • Drawing board (Main)
    • Usage or Guide (For Every Function there will be description respectively)
  • We can use react-router-dom to have the functionality of routing in react
  • Contributors can easily contribute as this will be in the scope of frontend and react.
  • For contributors we can just add Navbar(without design), Home Page component, About us component, Guide component. Let the contributors work on design and implementation.
  • How to run and all development documentation is already available in Readme file IG. We should not duplicate it.

@DhairyaBahl WDYT?

@MitAbhay
Copy link

MitAbhay commented Mar 2, 2022

@vedant-jain03 I agree with you, you should make different components so that we the contributors can contribute more efficiently. We can add all readme content in the Guide component.

@ajukadavid
Copy link

can we use VuejS instead?

@vedant-jain03
Copy link
Collaborator

can we use VuejS instead?

Any specific reason why?

@DhairyaBahl
Copy link
Member Author

DhairyaBahl commented Mar 3, 2022

@vedant-jain03

I think all of your listed ideas are great and should be implemented as soon as possible ! Kindly create appropriate issues for each one of them. Great Job.

@DhairyaBahl
Copy link
Member Author

@vedant-jain03 How about using this for this purpose. Idea of this project is great. Checkout if this fits our requirements.

@vedant-jain03
Copy link
Collaborator

Sorry for the late reply,

@DhairyaBahl I think it may be great if we have a lot of functions or a detailed explanation of a function. We can definitely consider the UI of the site you refer but what I feel is making all the forums or docs for the initial version of the project is not appropriate until and unless we have some really great function to work on.

What we can do :

  • I will set react-routing for About Us, Home page, and Use Guide. Also a simple navbar to route to them.
  • We can make issues of levels as follows:
    • Design About Us(Level 2)
    • Design Responsive navbar(Level -2)
    • Design Home page(Level -2)
    • Design Footer(Level -1)
    • Design User Guide(Level -3)

Let me know your views then I will start the procedure!

@mayank-del
Copy link

@DhairyaBahl ,i am a gssoc 22 participant, can i contribute in this issue.

@ajukadavid
Copy link

can we use VuejS instead?

Any specific reason why?

cause it's better

@navyasharma0203
Copy link

Can I work on this??

@vedant-jain03
Copy link
Collaborator

Can I work on this??

This issue is under discussion, can you check out other open & unassigned issues!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
discuss documentation Improvements or additions to documentation enhancement New feature or request good first issue Good for newcomers GSSoC22 This tag represents the issue or PR under the scope of Girls-script Summer of Codes' 22 Level3 Hard priority suggestions
Projects
None yet
Development

No branches or pull requests

7 participants