smaranjitghose / awesome-portfolio-websites

A community maintained open source project aimed at making a personal portfolio for researchers, developers, and analysts simple, fast, and less cumbersome. We make sure you have a full-fledged website to showcase your work while you can spend time on your learning and innovative endeavors.
https://portfolio.smaranjitghose.com/
MIT License
2.41k stars 1.52k forks source link

Update Project Usage Documentation #1147

Open smaranjitghose opened 2 years ago

smaranjitghose commented 2 years ago

NOTE: This is an issue that exclusively demands knowledge of Python. Please take this up only if you are comfortable beyond basics

Package to be used: MkDocs Material

Branch for source code: documentation

Please read through the documentation carefully and dedicate some time!

Documentation Requirements:

  1. Welcome [Refer the readme]

    • About the project
    • Why Open Source?
    • Programs we have been a part of
    • Sneak Peak (Use Gifs)
    • Team

    ** Please do beyond just copy-paste. Use your creative writing skills.

    1. How to start using it?
      • Install Git
      • Setup Git and GitHub Account
      • Navigate to GitHub Repository
      • Fork the repo
      • Clone the repo [ use git clone ..... --depth 1]
      • Access the local copy
      • Delete Additional Stuff ( Readme, Readme assets,etc)
    2. Page by Page Changes:
      • Home Page
      • Education Page
      • Project Page
      • Experience Page
      • Research Page
      • Social Media Links
      • Assets
      • SEO

    ^^ Detailed guide on which files to open, where to change the content and for what parts? Use screenshots of the changes!

    1. Publishing the portfolio!
      • Save the changes
      • The step by step to push to Github
      • Tip: On making the repository private if desired
      • Deployment + Using Custom Domain:
        • GitHub Pages
        • Netlify
        • AWS Amplify

Directions:

lavakush07 commented 2 years ago

"I want to work on this issue under JWOC"

anushbhatia commented 2 years ago

@lavakush07 do give regular updates here and if you face issues ask @smaranjitghose

lavakush07 commented 2 years ago

@lavakush07 do give regular updates here and if you face issues ask @smaranjitghose

Yeah sure..

smaranjitghose commented 2 years ago

@lavakush07 Updates?